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Section One Getting started 



Start here to find out how to get your Z88 working for you. 

This section contains four introductory chapters: 

Introducing the Z88 gives a foretaste of what the Z88 can do. 

Up and running explains how to insert batteries, switch on, and start 
writing your first document on the Z88. 

The Z88 applications and popdowns describes the programs provided 
in the Z88, to help you decide which you want to learn about first. These 
are then explained more fully in the later sections. 

Basic concepts explains a little more about the components of the Z8 8: 
the keyboard, the display, and how the functions work. 




Introducing the Z88 



Conventions in this manual 



The Z88 is a unique computer for several reasons. 

For the first time in a machine of its size and portability it offers you a 
powerful productivity tool, Pip eDr earn, capable of tackling the most 
demanding applications and providing all the capabilities normally only 
obtained by working with separate programs on much larger computers ; 
it combines in one program most facilities provided by the best word 
processors, database programs, and spreadsheets. 

To complement PipeDream, the Z88 comes complete with a range of 
utility programs, designed to anticipate any task you might wish to 
perform in the home or office; these include a clock, calculator, diary and 
organiser, and an alarm reminder. 

The Z88 also avoids the problems of storing documents and applications 
long-term by providing battery-powered circuitry which will retain all 
the information in the computer for over a year while it is switched off. 
The batteries also maintain the correct time and date in an internal clock 
and calendar. 

In addition, communication with larger computers is catered for by built- 
in transfer programs. 

In no time, the Z88 will revolutionise your life by making it possible for 
you to work with the tools you need, wherever and whenever you want. 



In this manual, anything displayed on the Z88 screen is shown in a 
computer typeface, such as 

Name of file to save 

Anything that you should type at the keyboard is shown in a different 
typeface to designate the keyboard keys; for example 



You are invited to a party 




Introducing the Z88 



The keys on the keyboard with a special function are shown in the text 
with key legends. So, for example, if you are asked to type 

myfile [enter] 

you would actually type the letters myfile and then press the 
[enter] key. 

In general, references to menu headings are in bold caps; for example 

LAYOUT 

References to individual commands are in bold; for example Save or 
Load. 



References to options displayed by a command are in italics; for 
example Save only range of columns. 




Up and running 



This section will explain how to get your Z88 working for you as soon as 
possible. Once you have tried out the simple examples in the next few 
pages you should have a feel for what the Z88 can do for you, before 
proceeding to the later sections at your leisure. 



Fitting batteries To run the Z88 you will need the following batteries: 

■ Four alkaline cells, Size AA, type MN1500 or LR6. 

Other types of the same size can be used in an emergency, but we 
recommend the use of the leak-resistant alkaline type as these will keep 
your Z88 working for longer without needing replacement. 

With these batteries an unexpanded Z88 will give about 20 hours of 
active computing, and the data will be preserved in the machine while it 
is switched off for up to a year. 

For heavy indoor use the mains power unit is recommended. 

Note that the procedure described here is not the same as the one for 
replacing existing batteries. In this case refer to Appendix A. 
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Inserting the batteries 



The four batteries are housed in a 
row in the battery compartment, 
under a flap on the rear of the Z88 
case. 



To insert batteries for the first 
time, use the following procedure : 




© Remove the cover from the © Insert the remaining two ® Replace the battery 

battery compartment on the back batteries to make an 'A' shape compartment cover firmly, 

of the Z88 case, and insert one above the case. Make sure that all 

battery at each end of the four batteries are facing in the 

compartment. same direction, with the correct 

polarity. 

Make sure the batteries are fitted 

the correct way round, as Then push down on the two 

indicated by the diagram in the batteries so that they click into 

battery compartment. place. 
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Section One - Getting started 



Initialise the Z88 

© Open the transparent cover to 
the card slots. 

© Locate the reset button, which 
is situated behind a hole on the 
left-hand edge of the Z88 case. 



® Press the reset button twice, 
using an unbent paperclip to 
reach into the hole. 



© Close the card slot cover. This 
gives a hard reset, initialising the 
Z88 to make it ready for use. 




Reset Contrast 




ip^r. i i n 1 1 ©l 1 1 I r 
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Set the clock 



When you first install batteries 
you will need to use the Clock 
popdown to set the correct date 
and time using the following 
procedure: 

© Press nT to enter the clock 
popdown. 

© Press O to highlight the Set 
option: 



CLOCK 



Tuesday 
17th March 
1987 

00:00:57 



SET 



® Press IenterI to enter the Set 
function, which displays the 
previous (incorrect) date and time, 
and will allow you to alter these 
to their correct values: 




L7/03/1987 



NEW TIME 



| 00:01:15 I 

You can move the cursor between 
the time and date with O' and 0 ■ 

You can also move the cursor left 
and right along the digits with the 
O and O keys. Moving off the 
end of the date will position the 
cursor on the time, and vice versa. 



© Having positioned the cursor, 
simply type the correct time or 
date, using the numeric keys 0 to 
9. The format of the new time and 
date should not change; if you 
type over the 7 ’ or ‘ : ’ signs, move 
the cursor back with the O key 
and replace them. 

When you ha ve set the correct 
values, press [enter] to confirm 
them, and after about two 
seconds the correct time and date 
will be displayed. 

Finally, press [esc] to exit from the 
Clock. 



Try typing text 



© Hold down the □ key (at the 
bottom left of the keyboard) and 
press the P key, to enter 
PipeDream. 




©Type Dear Sir, at the 
keyboard. Press the (del] key to 
delete mistakes. If you type more 
than will fit on one line, 
PipeDream will automatically lay 
out the text for you. 




© Return to the Index by pressing 
the [bsidexI key. Your letter will be 
kept as a suspended activity; go 
back to it by pressing DP again. 

You are now ready to proceed 
with the examples of using the 
Z88 in the following sections. 
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Section One - Getting started 



Switch off 

There is usually no need to 
worry about switching your Z88 
off. 

If you do not type anything for 
several minutes the machine will 
automatically switch off to 
conserve power. 



You should always switch your 
Z88 off before, for example, 
carrying it in a briefcase. This is 
because the keys may get 
pressed, disturbing what you 
were in the middle of doing, or 
keeping the Z88 on and wasting 
the batteries. 

To switch off press both [shift! 
keys simultaneously. 



To switch the Z88 on again at any 
time, press both IshiftI keys 
simultaneously. 



The Z88 applications and popdowns 



The applications 



The Z88 comes with two types of built-in program, called applications 
and popdowns. For most of your work, you will probably use the 
applications, for writing text, setting up financial calculations, or 
organising information and appointments. 

The popdowns perform simpler tasks, and are equivalent to desktop 
tools. They can be called up from within any application whenever you 
need them, and in the cases of the alarm clock, calculator and calendar, 
will generally be most useful for making a rapid check or record of 
information. So, in the middle of typing a letter, for example, you could 
use the Calculator to perform a quick calculation, and then return 
immediately to the letter. 

You can keep several unfinished documents in yourZ88 at once: when 
you return to one of them to continue working on it, everything will be 
exactly as you left it. The Z88 is designed to leave you free to do things 
in whatever order you wish, and whenever you want. It does the work, 
and leaves you free to get on with the thinking. 

The next few pages will give an overview of what the Z88 applications 
and popdowns can do. The TUTORIAL, in Sections Two, Three, and 
Four, then gives fuller descriptions of each application and popdown, 
with examples of their use. 



The following applications are provided in the Z88: 

Creating documents - PipeDream 

A typewriter may enable you to type in text, correct mistakes as you 
type them, and underline text, but as soon as you need to make 
revisions, you inevitably have to retype parts of what you have already 
written. 

In PipeDream you can carry out proof corrections, sorting operations, 
and complex calculations with a few keystrokes, without you having to 
retype any of the text. 
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Section One - Getting Started 



Some facilities, such as the ability to move blocks of text around, will be 
familiar to anyone who has already used another word processor. Other 
features, like the ability to put a list of items into numerical order or the 
ability to perform calculations on tables of values, are normally only 
found on specialist pieces of software specifically designed for these 
tasks. 

Organising your time - Diary 

The Diary program provides a quick way of organising events, and 
keeping day-to-day information, such as expenses. Like a desktop diary, 
there is a page for each day, on which you can write engagements and 
other information. But the Z88 diary also caters for the likelihood that 
you might want to find something you wrote down on a previous 
occasion; if you cannot remember even the month of a particular 
exhibition, just search for ‘exhibition’ and the Diary will find the page for 
you. You can also print out entries of a certain type, which makes it easy 
to produce expense claims, or worksheets. 

Writing a program - BBC BASIC 

The Z88 comes complete with the BBC BASIC programming language 
which will allow you to program the computer to carry out sequences of 
instructions. For example, if you wanted to process some complicated 
statistical data, or convert the format of a file, the simplest way to do 
this might be to write a program using BBC BASIC. 

BBC BASIC is also an ideal language for learning to program, and many 
books on programming are available for use with it. 

Talking to another computer - Terminal 

The Terminal application allows you to set up a conversation with 
another computer, using the VT52 standard. With a modem, this will 
allow you to access information databases via a telephone line. 

Create a printer driver - PrinterEd 

The applications will print on any serial printer connected to the Z88, 
but to make full use of a particular printer’s capabilities, such as special 
fonts and highlighting features, you may want to create your own driver 
selecting whichever features you require. The PrinterEd application 
makes this a simple task. 



The Z88 applications and popdowns 
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The popdowns 



Popdowns are programs you can call from within an application, to 
perform a service without breaking off from what you are doing. 

Managing resources - Index 

The Index popdown is the key to all other Z88 applications and 
popdowns. From here you can call any other application or popdown, or 
resume an activity you suspended on a previous occasion. The Index 
also contains the Card Manager, which shows what memory cards or 
plug-in applications are present in the Z88, and allows you to insert or 
remove cards. 

Performing rapid calculations - Calculator 

You can use the Calculator to make quick calculations - even if you are 
in the middle of doing something else at the time. Its features mclude 
ten memories, and a units-conversion facility. So, for example, you can 
convert from litres to gallons with a few key-presses. 

Looking up dates - Calendar 

The Calendar means that you can plan your appointments for the 
coming weeks at a glance; and when you need to make a Diary entry, 
you can use the Calendar with the Diary to find the day you want 
immediately (see p. 68 for details). 

Knowing the time - Clock 

The Clock will show you the time and date instantly, without your 
having to look away from whatever else you are doing. 

All files and suspended activities are labelled with the time and date, so 
be sure that you have set the clock before you use the Z88. 

Remembering appointments - Alarm 

The Alarm application allows you to set up a number of alarm 
reminders, with a given time and, if required, date. Each reminder can 
include a message, and reminders can be programmed to alert you at 
the same time every day, month, or other interval. You can even set the 
alarm to run a program. 
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Working with files - Filer 

The Filer gives you access to the Z88 filing system, where you can store 
documents and BBC BASIC programs in the Z88 RAM, or for more 
permanent storage on an EPROM card. Although the filing system 
supports a flexible hierarchical directory structure, for simple 
applications directories can be ignored. 

Customise the Z88 - Panel 

The Panel is a set of controls for the Z88, allowing you to tailor the way 
that the keyboard, filing system, sound, and serial interface work to your 
own preferences. 

Transferring files to another computer - Import/Export 

The Import/Export popdown enables you to transfer documents to or 
from another computer, using a simple set of commands. 




Basic concepts 



Before trying an application on the Z88, you need to be familiar with the 
basic concepts which are common to ail applications. These involve 
selecting what you want to do, be it running an application or 
performing an operation within an application, and then carrying it out 
with the appropriate command from the keyboard. 



The keyboard The Z88 keyboard looks like a normal typewriter keyboard with the 

familiar qwerty arrangement of letters. 



"T' 1 

! ESC 


■ 


■ 


l # l 


$ 

4 


in 


A 

1 6 


s 


l 8 


( 

9 


1 0 ’ 


B 


+ 


\ 1 


DEL 


TAB 


0 1 


w | 


E 


R 1 


T | 




« 1 


■ 


O 


■ 


■ 


m 


■a 




1 A 


s 


D 




G 


1 H 


m 


F 


■ 




■ 


i 


|M| 


SHIFT 




E 


in 


V 


l B 


|n 


M 






E 


? | SHIFT 


1 0 I 


fig 




HELP 


II D 




CAPS 

LOCK 


o 


o 


i o f 











There are some additional keys on each side of the keyboard which have 
the special functions explained below. 

The letter and number keys 

Press the letter keys alone to give the lower-case letters, or with IshiftI to 
get capitals. You can get capitals without needing to hold down [shift] by 
pressing IcapslockI - see below. 

Press the digit keys on the top row of the keyboard to give the digits, or 
with 1 shiftI to give the symbol above each digit on the key. 

Note that, unlike on some typewriters, the letter 0 is quite different in 
meaning from the digit 0, and the letter 1 (lower-case L) from the digit 1. 
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Section One - Getting Started 



On the left-hand side of the keyboard: 

[esc] will normally cancel what you are currently doing, and go back to the 
most appropriate point just before. 

fTABl is like the tabulate key on a typewriter. Use it for making columns of 
figures, or arranging tables. 

[menu! enables you to select which of the Z88’s operations you want to carry 

out. These are explained in greater detail in the section Using menus on 

p. 20. 

IindexI will return you to the Index from within an application. 

[help] gives you a display of information about the action you are currently 
carrying out. Further information is then available on related topics. 



□ introduces a short cut to calling an application or a popdown. 

O introduces a short cut for carrying out an operation within an application 

or popdcw r A list of the most useful of these operations is given on the 
Single key functions card, above the Z88 keyboard. 

On the right-hand side of the keyboard: 

[del] rubs out the last character you typed at the keyboard. 



IenterI is normally typed at the end of a line to confirm what you have just 

typed, or to go to the beginning of the next line, like the carriage return 
on a typewriter. 

0 , O , O, O move the cursor up, down, left or right on the screen. 

Caps lock modes 



Two caps lock modes are available which determine the way that the 
I shift! key operates. The mode selected is indicated by a symbol at the 
bottom right-hand comer of the screen. The state of the caps lock mode 
is stored with each application, so you can, for example, keep one mode 
set up for PipeDream and another for BASIC. The operation of each 
mode is as follows: 



Basic concepts 
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<> [caps lockI selects Normal Caps mode. The letter keys give capitals, irrespective of 
the [shiftI key. Displays: 

CHP5 

□ [CAPSLOCKl selects Invert ed Ca ps mode, giving capital letters normally, and lower- 
case with the [shift! key. Displays: 

cops 

IcapslockI switches on and off the selected mode. 

Special characters 

O ' gives ‘ ' ’ (grave accent), and OSPACE gives an exact space, 
displayed as 

Cleaning the keyboard 

The keyboard should be kept free from dust by cleaning it periodically 
with a damp lint-free cloth, or sponge. Solvents should not be used. 
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Section One - Getting Started 



The Index The Index popdown allows you to call up Z88 applications or popdowns, 

or to return to any activity that you were previously working on. 

To see the Index screen at any time, press the I index] key at the lower left 
of the keyboard. To return to an application from the Index, press (esc) . 

The components of the Index screen are identified below: 



Menu list 



Suspended activities CLI indicator 



Alarm symbol 



Shows the current application Lists the activities being Shows when the Command Flashes to indicate when 

or popdown name, and the kept in the machine. Line Interpreter is active an alarm is active. 




Applications and popdowns Key sequence display Battery low symbol Caps lock status 



Allows you to select and enter Shows O or □ key Appears when the Shows which caps 

an application or popdown. sequences as you type them. batteries need replacing. lock mode is active. 



The right-hand edge of the screen is reserved for status information 
from the Z88 operating system. It displays OZ when the Z88 is ready for 
use. 
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Section One - Getting Started 



Suspended activities 



Using menus 



If you return to the Index after creating a document in PipeDream (or 
writing a program in BBC BASIC), your activity will be suspended, and 
you will see it listed in the list of SUSPENDED ACTIVITIES. This shows 
the time and date you were last working on the document under the 
heading when suspended, and if a name has been given to the 
document (with the PipeDream OFC or OFL commands, or the BASIC 
*NAME command), the name will be shown in the column headed 
your ref. You can keep as many PipeDream and BBC BASIC 
suspended activities as you want, subject to the available memory. 

Re-entering a suspended activity 

You can re-enter a suspended activity by selecting it on the list of 
SUSPENDED ACTIVITIES. Move the highlighting bar across with the O 
key if necessary, and then press the IenterI key. Alternatively, pressing 
□P or OB repeatedly will enter each PipeDream or BBC BASIC activity in 
turn. 

Killing activities - OKILL 

Each suspended activity does, of course, use up some memory space; 
some for the document you are working on, plus a small overhead 
needed by the application. You can therefore kill activities you no longer 
need to work on in order to free the memory space. Save the document 
(or program) first if you may need it again. 

To kill a suspended activity, select it on the SUSPENDED ACTIVITIES 
list with the cursor, and type OKILL. The activity will be removed from 
the list, and any document (or program) associated with it will be lost. 



The Z88 applications, and some popdowns, use menus to show you 
what operations are available at any stage, and to give you a simple way 
of choosing the one you want from among them. In keeping with the 
philosophy of the Z88, menus free you from having to remember cryptic 
sequences of commands to be typed from the keyboard, and allow you 
to do what you want as quickly as possible. 

The items on each menu all relate to one particular type of operation. For 
example, all the operations to do with printing are listed on a PRINT 
menu. The menu headings are shown on the Menu List, which is 
displayed on the left-hand side of the screen under the name of the 
application or popdown. 
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To use menus you have to: 

© Select the menu you want from the menu list. 

© Select the operation you want to perform from that menu. 

© Execute the operation. 

These three steps are now explained in greater detail. 

Selecting a menu 

As an example of using menus, try using the menus in the PipeDream 
application. First enter PipeDream from the Index as already described. 



The menus available in any application are listed at the left-hand side of 
the screen , under the application name. 



For example, the menus in PipeDream are given under the heading 
p i pedrerm. Each title refers to one type of operation you can perform 
with PipeDream. For example, the first menu, the BLOCKS menu, 
contains operations you can perform on a block of text. 

Pressing the [menu] key will display this menu, and blocks will be 
highlighted in bold lette rs on the Menu List. To look at a menu further 
down the list, press the ImenuI key until you reach it. If you go past the 
menu you want, keep pressing the ImenuI key until it circles back around 
to the top of the list. 



PI PEDRERM 






Search 


❖BSE 


Word Count 


oBWC 




oz 




Cle-ar Mark. 


oQ 


Repl ace 


«E:RP 


New 


oBNEW 


RDURNCE 




CURSOR 


Copy 


OBC 


Next Match 


oBNM 


Recalculate 


OR 


« <> -o- & 




EDIT 


Move 


OBM 










SELECT 




FILES 


Delete 


oBD 










MEjrnyBg 




LRYOUT 


Sort 


OBS0 














OPTIONS 


Replicate 


OBRE 










mYscWm 




PRINT 














RESUME 





For example, to select the FILES menu, you need to press the ImenuI key 
three more times. You can always check which menu is displayed by the 
title in bold on the Menu List. 
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PIPEORERM 




- -»HJ 


Next F il e 


oFN 




BPS? 


BLOCKS 


Previous File 


oFP 




RDURNCE 


CURSOR 

EDIT 

FILES 

LRYOUT 

OPTIONS 

PRINT 


Nane 


oFC 


Top F il e 
Bottom File 


oFT 

oFB 




<> <> ^ 
SELECT 

RCTION 

[S3 

RESUME 



oz 



Selecting an operation 

You select a menu item by moving the highlighting bar with the cursor 
keys until the operation you want is highlighted. 

Executing the operation 

To perform the highlighted operation, simply press the [enter] key. 

For example, on the BLOCKS menu example shown above, press the 
IenterI key to perform the Mark Block operation. 

Options 

Many operations give you a list of options before actually carrying out 
the command. The Save command, on the FILES menu, is an example; 
press O’ to highlight the Save command. When you press the [enTer] key 
you will see the following prompts: 



Nane of file to save ■ 

Save only range of columns No 

Save selection of rows No 

Save marked block No 

Save plain text No 

In this case you can simply type in a file name, such as 

Nane of file to save Myfilel 



and press the IenterI key to carry out the Save. 
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The other options under the Save command have only two possibilities 
each, Ye- s and No . You can alternate between them in two different 
ways: 

© Type Y for Yes and N for No as appropriate. 

© Use the Next Option or OJ command to display the alternative 
value. (With options which have specific values, OJ will restore the 
default; see Setting the options, p. 103, for more details.) 

Escaping from an operation 

If you decide against performing an operation from the menu, press the 
[esc| key and the menu will disappear from the screen. 

It may take you a little while to become familiar with using the menu 
operations to carry out your wishes, but once you have mastered menus 
you will be able to use all of the applications on the Z88 without 
difficulty. 



Short cuts - O Menus make it easy to locate what you want to do even if you are not 

familiar with an application. But with a little experience you will find 
you know exactly which operation you want to carry out, and so will 
appreciate the short cuts which allow you to carry out any action 
without going through a menu. 

Each operation can be called up by typing the special O key (called 
‘diamond’), followed by a sequence of one or more letters. When you 
type a O sequence, the operation will be carried out instantly, no matter 
what you were doing in the application. If you do not keep the O key 
held down while you are entering a O sequence, the letters are shown 
at the right-hand side of the screen as a reminder. 

The short cuts are shown on each menu so that you can refer to them if 
necessary. For example, the short cut for the Save operation, shown on 
the FILES menu above, is OFS. Also, the most useful of these operations 
are shown on the list of key functions above the Z88 keyboard. 

Note: Normally O and □ may be used either by holding them down 
whilst typing the sequence, or by pressing and releasing them and then 
typing the sequence. There are two exceptions to this; these are OESC 
and OESC where they must be held down. 
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Section One - Getting Started 



Line editing 



0,0 

00,00 



[SHiFTlfDELl 

OD 

OT 



In most situations where you are entering a line of text in the Z88, such 
as in response to a prompt, the following commands are available to 
make corrections and alterations to what you are typing: 

moves the cursor left and right 

moves the cursor to the beginning or end of a line 

deletes the previous character 

deletes the character at the cursor position 

deletes to the end of the line 

deletes a word 



Memory low condition When you have almost filled the Z88 memory, with applications or data, 

the menu-selection of commands is automatically disabled to conserve 
memory. The highlight bar disappears, and the prompt display, at the 
right-hand side of all menu screens, changes to indicate that menu 
commands can no longer be selected with the cursor keys: 



mm 


oz 


ADVANCE 




MEMORY 




LOW 








RESUME 





In the memory-low condition the command short cuts must be used until 
enough memory has been freed from the machine. 



Soft and hard reset Soft reset 

In the unlikely situation of the Z88 not responding to any keyboard input 
it can be given a soft reset. This will remove all the applications running 
in the Z88, and clear any temporary work space being used by the 
operating system, but should retain all files. 
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To give a soft reset, press the reset button twice. The display will briefly 
show 

SOFT RESET . . . 

and then return to the Index. The operating system does its best to 
retain all files in the internal or external memory, and usually succeeds. 

Hard reset 

Hard reset completely initialises the Z88, clearing all memory, losing all 
files, and resetting the clock. Hard reset is described in Initialise the 
Z88, p. 8. After a hard reset the Z88 will display 

HfiRD RESET . . . 



Help The Z88 contains a Help system with highly-structured information on 

many operations and facilities provided by the machine. The problem 
new users of a computer often face is that they need to find out how to 
do something but are not guite sure where to look. The Z88 Help system 
overcomes this problem by allowing you to ‘browse’, from Help 
information on one topic to information on related ones which might also 
provide the information you require. The help information is limited on 
the basic machine, but there is the provision of extending it with a Help 
application card. 

Getting help 

To find out information about a particular topic all you have to do is 
press the [help] key at the bottom left-hand side of the keyboard. The 
Help system will then automatically give you information on the menu or 
operation within the application you are currently using. 

Browsing within Help 

The cursor keys <□ O 0 -O and the IhelpI key allow you to obtain more 
information, as shown on the Help screen. 

Returning to your application 

To exit from the Help system and return to your application, press the 
(escJ key. 
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Section Two Using PipeDream 



This section will familiarise you with all the essential facilities provided 

by PipeDream, through a series of three simple worked examples: 

■ Design a party invitation, using PipeDream’s text editing and page 
layout facilities. 

■ Set up a name and address list, using PipeDream’s ability to 
organise information. 

■ Calculate home expenses, using PipeDream’s facilities for working 
with tables of figures. 



Starting PipeDream 



Before trying the sample applications using PipeDream, this section 
shows how to start PipeDream, and introduces the fundamental 
concepts necessary to an understanding of how to work with it. 

First start PipeDream with a blank document from the Index. To do this: 

© If you are not already in the Index, press the IindexI key. 

© Select PipeDream from the Index APPLICATIONS list. Press O to 
move into the APPLICATIONS list, if necessary, and press O or 0 
until P i p eD r e an is shown highlighted. 

® Press the IenterI key to enter PipeDream. 

You will see the PipeDream opening screen, confirming that you have 
selected the PipeDream application. 

Slot coordinates Cursor column Top border Right-hand margin 

The column and row The column containing the Marks character positions The right-hand edge of text 

coordinates of the slot cursor is indicated by close across the screen, and the typed into the document, 

currently containing the dots on the top border. column headings, 

cursor. / i | 




Row number Cursor End of text marker Page display map 



The number of the row A flashing block indicating Indicates the bottom of the This area of the screen 

or line in the document. where text will appear as you document. displays a map of the 

type. text on the current page. 
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For clarity, the subsequent diagrams in this chapter show the central 
portion of the screen only. 

Page display map 

The page display map gives you an overall view of the current page of 
the document you are working on in PipeDream. Each character in the 
document is represented by a single dot in the map, enabling you to see 
the layout of the whole page and, if necessary, to adjust the layout to 
improve the appearance. 

At any time the lines on the map corresponding to those displayed on 
the PipeDream screen are indicated by a vertical bar at the right-hand 
side of the map: 




Lines displayed on 
the Z88 screen 



To make best use of PipeDream it is important to understand some basic 
principles of how PipeDream documents are constructed. 

Rows and columns 

Every document is divided into rows or lines, numbered 1,2,3... etc, and 
one or more columns, labelled with letters A, B, C... etc. Initially the 
document has 6 columns, labelled A to F, each of which is 12 characters 
wide, but commands are available for you to alter the widths of 
individual columns or to alter the number of columns. 

The part of a document lying in one row and one column is called a slot. 
A slot is referred to by its column label and its row number; for example, 
the following diagram shows slot D3 highlighted by the highlighting 
bar: 
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The coordinates of the slot containing the cursor are shown at the top 
left of the PipeDream screen, and the column containing the cursor is 
identified by closely-spaced dots on the top border. 

The right-hand margin is indicated by the 4- symbol on the top border, 
and normally all columns have their right-hand margins at the right- 
hand edge of the screen. 

Much of the power and flexibility of PipeDream comes from the two 
different types of slot which you can create and combine within a single 
document: text slots and expression slots. Each type of slot can contain 
up to 240 characters. 

Text slots 

Text slots are used for entering and editing continuous text, such as the 
body of a letter, a technical paper, or a novel. 

When working with text, the columns in PipeDream behave as if they 
are on different layers, like separate overlapping sheets of paper. For 
example, the initial column format could be represented by the following 
diagram: 
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Text typed into column A behaves as if it is on the bottom layer, which 
is 72 characters wide; it will 'show through’ the other layers, unless 
they contain text or expressions in the same row. 

Text typed into column F behaves as if it is on the uppermost layer, 
which is only 12 characters wide 

When text is typed into a text slot it will automatically wrap around to 
the start of the next row in the same column when the cursor reaches 
the right-hand margin for that column (unless wrapping has specifically 
been turned off). 

Formatting 

If justified text has been selected, from the Options Page, lines will be 
padded with spaces so that the right-hand margin is even. The layout of 
a document can be altered simply by moving the right-hand margin, and 
then reformatting the text paragraph by paragraph. 

By giving each column a different right-hand margin, independent 
columns of text can be created within the same document. With a little 
practise you will find that PipeDream is capable of creating quite 
complex multi-column page layouts. 
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Expression slots 

Expression slots, on the other hand, are used for creating tables of 
figures or information, often called spreadsheets. These can contain 
mathematical expressions, including references to other slots in the 
document, and scientific functions. 

The main difference between expression slots and text slots is that once 
you have typed the expression into an expression slot, what is displayed 
in the document is not the expression itself, but the result of evaluating 
the expression. For example, if you typed 1 . 15*300 into an expression 
slot, the result 345 would be displayed in the document. 

For spreadsheet work you can make all slots work as expression slots by 
default by setting the Options Page Text/Numbers setting to Numbers; 
see p. 140. 

Mixing text and expressions 

Text slots and expression slots can be mixed in the same document; so 
a letter could include a table of financial calculations automatically 
added together by PipeDream, or a company business plan could 
incorporate a spreadsheet within the descriptive text to show financial 
predictions. 

Values from expression slots can be included within formatted text in 
text slots using ‘@-fields’. This is convenient if, for example, you want a 
letter to refer to the result of a particular calculation. 

The examples 

The concepts of rows and columns, text slots and expression slots, and 
formatting text, are illustrated by the following three practical examples 
in the use of PipeDream. 
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This chapter will explain how to: 

■ Type in text 

■ Make corrections to the text you have entered 

■ Create bold and underlined text 

■ Alter the layout of text 

■ Save the document 

■ Print the document 



Starting PipeDream This example shows how PipeDream can be used in a typical word- 

processing application. To enter PipeDream from the Index starting with 
a blank document, select PipeDream from the Index, and press the IenterI 
key. 



Typing text Type the following: 

You are invited to a beano. 

Notice that the cursor moves to the right as you type. The next character 
you type will always be typed at the position indicated by the cursor. 

A short time after you stop typing, you will see the page map, on the 
right-hand side of the screen, change to show the new layout of text on 
your page. 
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Deleting Press the (del] key at the top right-hand side of the keyboard, until the 

word beano disappears. 

(del] backspaces the cursor over the text you have typed, removing it 
from the page. 



Word wrap Type the word party and then continue to type the paragraph shown 

below. If you make a mistake, use the [del] key to correct it. 

When your typing reaches the right-hand margin, indicated by the l 
symbol on the top border, just keep typing and PipeDream will 
automatically carry words over to the start of the next line. 

You are invited to a party to celebrate the creation of 
my first document with the Z88 computer. Champagne will 
be provided. 



Adding text PipeDream starts in Insert mode, although you also have the option of 

working in another mode called Overtype mode. You can change modes 
with the Insert/Overtype command; see p. 119. 

In Insert mode, text is always added at the position indicated by the 
cursor. You can add text simply by moving the cursor to the point where 
you want the text added, and then typing. The cursor is moved around 
on your document using the four arrow keys, O , O , O , -0 at the 
bottom right-hand side of the keyboard. 
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Position the cursor after the word champagne, on the second line of the 
text you have just entered, press the space bar, and add the phrase: 

and smoked salmon 

The original text will move apart to make room for the new text, and 
words will wrap around to the next line at the right-hand margin to 
ensure that the altered text is correctly formatted. 



R2 



R B C D E 

1 Vou are incited to a party to celebrate the creation of my first 

2 document with the 288 computer. Champagne and smoked salmon Eill be 

3 provided, 



,4-F 



Starting a new paragraph After adding the new text press the IenterI key. Ienter] moves the cursor 

to the beginning of the next line. 

Press [enter] twice more to leave a blank line and move the cursor down 
to row 5 on the page. Type the following: 

Sunday 28th February at 12 o’clock. 

You can use the IenterI key to end paragraphs, insert blank lines, and 
separate items in a list. 



R5 



R B C D E 

1 Vou are invited to a party to celebrate the creation of my first 

2 document with the Z88 computer. Champagne and smoked salmon will be 

3 provided. 



,4-F 



Sunday 28th February at 12 o'clock. 

■*iiEr 



ot text 
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Columns The page you are working on is divided into six columns, each 12 

characters wide, shown by the rows of dots and the letters A to F on the 
top border of the screen. These provide the equivalent to tab positions 
on a typewriter. 

With the cursor still on row 5, press [TAg exactly five times. The cursor 
will move to the left-hand edge of each column in turn until it reaches 
the left-hand side of the column labelled 'F'. Notice that as the cursor 
moves into each blank slot, text overlapping the slot is hidden. Now type 
in the text: 

RSVP 



The text will be positioned near the right-hand side of the sheet, 
opposite the text already on row 5. 



F5 



fl B C D E 

1 Vou are invited to a party to celebrate the creation of my first 

2 document with the Z88 computer. Champagne and smoked salmon will 

3 provided, 

4 



5 Sundau 28th February 



at 12 o'clock. 



RSUPI 



,4-F 



be 



You can move to the previous tab position by holding down the IshiftI 
key and pressing [tab] . Try doing this to move the cursor back into 
column A, at the left-hand side of the screen. 



Replacing text You can remove characters from the middle of a line by using the Delete 

Character command which you can give either using the EDIT menu, or 
by holding down the IshiftI key and pressing [del] . 

Now you decide to change the day of the party to Saturday 28th 
February. Move the cursor across to the S of S u n d a y with the cursor 
keys. Then, hold down the IshiftI key and press (del) ; the S will be 
deleted. Keep pressing IshiftI [del] until the word S u n d a y is removed. 
Then, type in the word Saturday to replace it. 
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Inserting a line Now add a heading to the invitation. To do this, you first need to insert 

two blank lines at the top of the page. 

Move the cursor up to the first line of your document, row 1, by pressin 

0 . 

Now give the Insert Row command. You can do this either using the 
EDIT menu, or by typing ON. A blank line will be added where the 
cursor was, and the remaining lines of the document will be moved 
down on the page. 

Type ON again to give two blank lines at the top of the page. Then type 
in the following text: 

A Once- i n- a - 1 i feti me Party 



fll 



fl B C D E 4F 

1 fl Once-in-a-lifetime Partyl 

2 

3 Vou are invited to a party to celebrate the creation of my first 

4 document with the Z88 computer, Champagne and smoked salmon will be 

5 provided, 



The bottom line of your document will not be visible as it is off the 
bottom of the screen. You can make it scroll into view by moving the 
cursor down with the O’ key. Move the cursor back to the top line with 
the 0 key before continuing with the example. 



Adding styles to text You can emphasise key phrases in your text by changing the style to 

bold, underlined or italics. This is achieved by selecting one of the 
highlight commands from the PRINT menu, or by typing one of the 
following highlight commands: 



Command 


Effect 


Highlight code 


OPU 


for underlined text 


1 


OPB 


for bold text 


2 


OPI 


for italic text 


4 
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Type the command once at the beginning of the text you want to 
emphasise, and give the same command at the end of the text you want 
to emphasise, to switch back to normal text. 

To emphasise the heading of the invitation, move the cursor to the 
beginning of the heading with the O key. Then type OPB. A ‘2’ symbol 
will be inserted before the text to indicate that a highlight code 2 has 
been inserted. Move to the end of the heading with the O key, and type 
OPB again. Another ‘2’ symbol will be inserted. Now move the cursor 
down to the next line with the O key and the heading will be displayed 
bold on the screen. 

When you move the cursor onto the line containing highlights, the codes 
are displayed as highlighted numbers U to E so that you can edit them, 
or delete them, just like any other text characters. When you move the 
cursor onto another line, the effect of each highlight is shown on the 
screen, just as it will appear when printed out. (Italic text is displayed as 
tiny characters.) 



Altering the layout Of text You can alter the layout of one or more lines of text in your document 

with one of the Align commands on the LAYOUT menu. For example, to 
centre a line of text, you move the cursor onto that line and then select 
the Centre Align command from the LAYOUT menu. Alternatively, you 
can type OLAC. 

Move the cursor onto the line containing the heading of the party 
invitation, if it is not there already, and type OLAC. You will see the 
heading become centred on the page map (which always shows you the 
format of the page as it will appear when printed). The actual line of text 
will be centred on the document when you move the cursor onto the 
next line. 



fl B C D E 4F 

1 fl Once-in-a-lifetime Party 

2 I 

3 Vou are invited to a party to celebrate the creation of My first 

4 document with the Z88 computer. Champagne and smoked salmon will be 

5 provided. 
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Saving your document 



Once you have finished working on a document it is a good idea to save 
it as a file to the Z88 RAM. You will then be able to find it again without 
difficulty at a later date, and there is the added advantage that 
documents saved to the filing system take up less space and are more 
secure than documents left within PipeDream. 

You can save a copy of your document into the Z88 filing system by 
selecting Save from the FILES menu: 

© Press the ImenuI key until the FILES menu is displayed on the screen. 

© Press the O key to highlight the Save command. 

® Press IenterI to select the Save command. 

The Save command optionally allows you to save only part of your 
document, and therefore prompts with the following questions: 



Name 


of file to save 


■ 


Save 


only range of columns 


No 


Save 


selection of rows 


No 


Save 


marked block 


No 


Save 


plain text 


No 



Type in the name I n v i t a t i o n as the name of the file to be saved, so 
that the top prompt becomes 

Name of file to save Invitation! 

and press IenterI , since on this occasion you do not need to select any of 
the other options. 

A copy of the document will be saved with the name I n v i t a t i o n in the 
Z88 filing system. You will see the file I n v i % at- ion listed if you 
select the Filer by typing DF. Press Use) to return to PipeDream. 

If at some stage you expand the Z88 with a RAM card, you can save a 
document to the extra RAM by referring to it in the file name as, for 
example: 



: RAM. 1/Invitation 
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Loading a document 



Printing the document 



Try loading back the document you have just saved using the 
PipeDream Load command. 

First clear the invitation from PipeDream by giving the New command 
from the BLOCKS menu. If you have altered the document since you 
saved it, the prompt 

Overwrite text? 

will be displayed at the top of the display, to give you the chance to go 
back and save your changes. Press Y to clear the document. 

Then select the Load command from the FILES menu. As in the case of 
the Save command, fill in the file name in the list of options 

Nane of file to load Invitation! 

and press IenterI to load the file. You should see the invitation exactly as 
you saved it. 



If you have a printer connected to the Z88, you can print out a copy of 

the invitation with the following procedure : 

© Select the PRINT menu by pressing the ImenuI key until PRINT is 
highlighted on the Menu List. 

© The Print operation may already be highlighted as it is the first item 
on the menu; otherwise use the cursor keys to select it. 

© Press [enter] to give the Print command. 

© Press IenterI again to ignore the Print options and print the 
invitation. 



You can repeat the procedure to print as many copies as you want. 
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A Once-in-a-lif etime Party 

You are invited to a party to celebrate the creation of my first 
document with the Z88 computer. Champagne and smoked salmon will be 
provided. 



Saturday 28th February at 12 o'clock 



RSVP 




To get bold and underlined text to print correctly you may need to use 
the Printer Editor; see Section Nine - The Printer Editor, p. 187. 



What next? You have just seen how the Z88 makes it a simple matter to write text, 

correct mistakes, alter the layout, and print a document. 

The Z88 also enables you to compile a catalogue of information, as 
demonstrated in the next worked example. 




Compiling a name and address list 



This example shows how you can enter any type of information such as 
a library catalogue, a book index or bibliography, or a name and address 
list into the Z88 using PipeDream. 

You will leam how to : 

■ Enter information 

■ Find any particular information you want 

■ Organise the information 

■ Print out all, or a selection, of the information in an orderly table 



Preparing the document Because you are going to enter lists of information, rather than a block of 

text for formatting into a document, you should first alter the Wrap 
option on the Options Page so that words do not wrap around onto the 
next line when they reach the right-hand margin. 

Select the Options Page by typing OO. You will see a display showing 
the different options you can select for your document, and information 
about the document. 

Move the cursor down to the wrap option by pressing O until the cursor 
is opposite the word Wrap. Then type N to change the option value from 
Y (Yes) to N (No) to stop wrapping altogether: 



T ext/N umbers 


T 


Insert on wrap R 


Margins: Top 8 


File 


No File 


Borders 


V 


Calc: AutoxMah A 


Header 2 


Page 


1 Insert 


Justify 


N 


Columns/Rows C 


Footer 2 


Free 


20488 


Wrap 


U 


Decimal places 2 


Bottom 8 






Page length 


b6 


Minus/'Brackets M 


Left 8 


Title 




Line spacing 


1 


Lead chs, £ 


Header 






Start page 




Trail chs, k 


Footer 







Finally press the [esc] key to return to the document. 
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Setting up headings 



Before entering information into PipeDream, it is good practice to set up 
headings to specify how the information will be arranged. Since you are 
going to create a name and address list, the headings will simply 
correspond to the name and address, with one reserved for additional 
information. 

When you start a new sheet in PipeDream you are given six columns, 
each 12 characters wide. Although you can enter lines of text much 
wider than this in each column, it will make working with the name and 
address information simpler if, at this point, you make each of the 
columns in the document wider. You do this with the Width command 
in the LAYOUT menu. 

Press the [menu! key until the LAYOUT menu is displayed. The Width 
command may already be highlighted as it is the first item on the menu; 
otherwise use the cursor keys to highlight it. Then press IenterI to select 
it. In reply to the prompt 

New width 

type 

24 

and press IenterI to carryout the change. (You can ignore the other 
prompt -Specify column.) 

The width of the column containing the cursor, column A, will increase 
to 24 characters. 

Now move the cursor into column B by pressing the [tab] key, and repeat 
the procedure to set the width of column B to 24 also. You can, if you 
wish, select the Width command directly without going through the 
LAYOUT menu, by typing OW. 

Continue until you have set each of the columns A to F to a width of 24 
characters. Notice that when you press the [TAB) key to get from column 
C to column D, the document moves to the left on the screen so that 
columns D and E come into view without the cursor position changing. 

Then move the cursor back to the left-hand side of column A by typing 
OfTABl. 



Type the following headings, pressing the [Tab] key between each 
heading to move the cursor to the beginning of the next column. 
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Name [Tab] 

Address [to] 

Town [tab] 

County [tab] 

Postcode [tab] 

I nfo 

Notice that when you type the word Town and press the [TAB] key, the 
document scrolls to the left so that the column headed ‘D’ comes clearly 
into view: 



D1 








D 


- 


- 




1 Address 


T own 


1 























So, although you can only see three of the six columns in your document 
at any one time, it is a simple matter to move about and find the 
information you want. 

Although it should be quite obvious what you will be using each of the 
first five headings for, you may be wondering what the purpose of the 
last heading Info might be. You can use this to record additional 
information about all of the people in your address list, such as whether 
you sent them a Christmas card last year, when their birthday is, or any 
other information you would like to be able to recall. In the following 
examples the field will contain the person's age. 



Entering some information Move the cursor back to the left-hand side of column A by typing <>[Tab] . 

Press the IenterI key to move the cursor to row 2. 

You can now type the first name into slot A2. 

Bell, A 

Press the [to] key when you have finished typing the name to move the 
cursor across to the address column, column B. Type in the address, 
remembering to press the [tab] key between each item: 
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Bell, A [tab] 

2 Ringway [Tab] 
Tring [TAB] 
Herts QM] 

TE1 2LM (Si 
24 



R3 



1 Name 

2 Bell, R 

3 



Rddress 
2 Ringway 



T own 
Trin9 




Enter the other names and addresses given below on lines 3,4,5, and 6 
of your document in exactly the same way. Of course, if you prefer, you 
can compile your own list. If part of an address is too long to fit within 
one column, just keep typing; although you will not be able to see all the 
information in that column, it will be retained and you will be able to 
refer to it later. 

Also, be sure to keep to the headings at the top of the document. For 
example, if a particular address does not have anything corresponding 
to a county, leave that column blank so that you put the postcode under 
the correct heading. This will enable you to search for a particular 
postcode, as described later. 

Complete the table as follows: 



Name 




Address 


Town 


County 


Postcode 


Info 


Bell , 


A 


2 Ringway 


Tring 


Herts 


TE1 2LM 


24 


Long , 


C 


9 Knott Close 


Farnham 


Surrey 


WAY 2G0 


27 


Rover 


, A 


4 Chase Mews 


Keni 1 worth 


Warw. 


K9 WUF 


12 


Bi rd , 


J 


27 Wood Lane 


Bath 


Avon 


CB1 L23 


14 


Hill , 


Max 


10 Upper Street 


Steep 


Hants 


UP 2IT 


43 
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Saving the document Since by now you may have spent some time entering information into 

your document, it is a good idea to save a copy to the Z88 filing system 
in case you accidentally lose the information during the next 
experiments. You save a copy of the document by using the same 
procedure as the one used for the party invitation. 

Select the Save command by pressing the ImenuI key until the FILES 
menu is displayed. Press the 0 key to highlight Save. Then press Ienter] 
to give the Save command. 

Type addresses as the name of file to save, ignoring t he oth er options 
since you want to save the whole document, and press Ienter] . A copy of 
the document will now be saved to the filing system. 



Sorting the information Now that you have entered a table of names and addresses, it would be 

useful to have them sorted into alphabetical order so that you can look 
up a particular name more easily. 

First you need to specify which part of your document you want to sort. 
Move the cursor to slot A2, the top left-hand comer of the table of names 
and addresses, using the u and 0 keys to move up and down the 
document and the (ta§ and [shift] [tAb] commands to move across the 
document between columns to the left and right. 

Mark slot A2 by giving the Mark Block command from the BLOCKS 
menu, or by typing OZ. 

When you give the command, slot A2 will be highlighted on the screen 
to indicate that it has been marked: 



FI2 


FI 


, , . ,B 


r fe. n*. ►- f 


1 Name 


Address 


Town 


C 


3 

4 Rover, fl 

5 Bird, J 

6 Hill, Max 


■■■■2 Ringway 

9 Knott Close 
4 Chase Mews 
27 Wood Lane 

10 Upper Street 


Tring 

Farnnam 

Kenilworth 

Bath 

Steep 


H 


S 

w 

H 

H 



Now mark the bottom right-hand comer of the table of names and 
addresses. Move the cursor down to row 6 and across to column F with 
the -0 key and the [TAg command. Then give the Mark Block command 
again. When you have completed the second Mark Block command, the 
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entire table of names and addresses will be selected and shown 
highlighted on the screen. 




The highlighted table of slots is referred to as a ‘block’, and several 
commands are available which will operate on an entire block of slots 
that you have selected. 

Move back to the left-hand side of the sheet with OfTABl. 

To sort the block of slots, use the Sort command from the BLOCKS 
menu. Press the [MENU] key until the BLOCKS menu is displayed. Then 
press the -0 key until the Sort command is highlighted on the menu, and 
press IenterI to select the command. 

We wish to sort the names and addresses into alphabetical order of the 
names, which are in column A, so type A to the prompt 

Sort on column R 

and press the IenterI key to perform the sort. (You can ignore the other 
prompts for the moment.) 

You will see that the names and addresses have been correctly sorted 
within the table. You can clear the marked block by giving the Clear 
Mark command from the BLOCKS menu, or by pressing OQ: 



H6 


fl 

Address 


T own 


R* FS»- kt. E 


1 Name 


C 


2 Bell, fl 


2 Ringway 


Tring 


H 


3 Bird, J 


2? Wood Lane 


Bath 


fl 


4 Hill, Max 


10 Upper Street 


Steep 

Farnnam 


H 


5 Long, C 


9 Knott Close 
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6 liooer, fl 


4 Chase Mews 


Kenilworth 


IjJ 
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Section Two - Using PipeDream 



Finding information 



You could, of course, have sorted the information on a different heading 
by specifying another column, rather than column A, when you gave the 
Sort command. For example, you may like to experiment with sorting 
the same names and addresses on the Town column, or on the column 
containing the peoples’ ages. 



You could have entered many more names and addresses than the few 
you have already stored without running out of space in the document. 

You can see how much space is available in a document at any time by 
typing 00 to display the Options Page. The number of characters of 
space available is given after the heading F r e e on the right-hand side 
of the Options Page display. Press He] to return to your document. 

In a large list of names and addresses, it would be very inconvenient to 
have to search around in the list for a particular name or address. 
Fortunately, there is a much faster way, using the automatic search 
facility built into PipeDream. 

Select the Search command from the BLOCKS menu in the usual way: 
display the BLOCKS menu with the ImenuI key, and use the cursor keys to 
highlight Search; then press IenterI to give the Search command. 

The Search command displays a number of options which allow you to 
specify exactly what you want to search for, and whether you want to 
restrict the search to a particular part of your table of information. 

For example, you might want to search for the address of someone 
whose surname you had forgotten, but whose Christian name you knew 
to be Max. You would then enter Max against the first option: 

String to search for Max 

Press 0 to move to the next option which initially shows: 

Search only range of columns No 

and press Y to alter the option value to Yes, and type A, to specify that 
you want to search only column A, which contains the names. The 
option will now read: 



Search only range of columns 



Yes fl 
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Then press [enterI to begin the search. The cursor will instantly find the 
name Hill, Max, allowing you to read off his address. 

Incidentally, if the name you chose to search for found someone else 
with the same name first, you could use the Next Match command on 
the BLOCKS Menu to move on and find the next item that contained the 
same name. 



Help with searching It is a peculiarity of the way we remember information that we can often 

only remember part of what we are trying to recall. For example, we 
may know that the person we are trying to find lives in a town called 
something like Caxton - or perhaps it was Croxton? Or then again, 
perhaps it was Foxton. The PipeDream Search command has two 
facilities which help in just this type of situation. 

You can type the symbols A # in the string you are looking for, to 
represent any combination of letters (including none). Thus, you simply 
have to specify 

String to search for A #xton 

to find any of the towns, Caxton, Croxton or Foxton, or any other town 
ending in ‘xton’. 

You can also specify the symbols A ? which will match any single letter 
or character in the string you are searching for. So, if you could only 
remember that the name of a road had three letters, you could search for 

a?a?a? Road 

and you would be sure to find it. 



Printing information To print out the information in your name and address list as an or derly 

table, select the Print option from the PRINT menu. Press the ImenuI key 
until the PRINT menu is displayed. Select Print using the cursor keys, 
and then press IenterI to give the command. 

Since the total width of the table of names and addresses is 144 
characters (six columns of 24 characters) it will probably be too wide to 
fit across the width of the paper on your printer; most printers will only 
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Section Two - Using PipeDream 



Printing selected rows 



print 80 characters. You will therefore need to print the table in two 
sections, by selecting a range of columns in each case. 

The first time you give the Print command, alter the option 

Print only range of Colunns No 

to Y es by typing Y, followed by A C so that the option reads 

Print only range of colunns Yes A C 

Then press the [enter! key to start printing. Once this is finished, give the 
Print command again, this time specifying the option as 

Print only range of colunns Yes D F 

Alternatively, some printers will print up to 132 characters across; in 
this case you may be able to fit the whole table onto a single sheet of 
paper by first reducing the width of some of the columns using the 
Width command on the LAYOUT menu. 



If you were going to use the name and address list for a business mail 
shot, you might want to compile a selective list containing only the 
names and addresses of people living in one particular area. The 
PipeDream Print command caters for this by allowing you to specify a 
test to be performed on each row of the document. Only those rows for 
which the test succeeds will be printed. 

You specify the test in terms of slots in row 1; PipeDream automatically 
alters the slot coordinates to refer to the appropriate row as testing 
proceeds through the document. 

For example, to print out the names and addresses of all the people 
living in Hants or Surrey, give the Print command in the usual way by 
displaying the PRINT menu and then pressing IenterI to give the Print 
command. Then move the cursor to the option 

Select rows to print No 

Change the option value t o Y es , by typing Y , and type in the selection 
expression 

Dl="Hants" ! Dl=" Surrey " 
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The 1 ! ’ symbol means ‘OR’, so the whole expression means: “If the item 
in slot D1 is Hants or the item in slot D1 is Surrey...”. In row 2 the test 
will apply to D2, and so on. 

The selection expression can be virtually as complicated as you need, 
and can include tests on several different columns. For example, for a 
mail shot of information on a new wonder hair tonic you might want to 
select all men over 30 on the name and address list. The expression 
might be 

Dl=" London" & G1="M" & Fl>=30 

where G1 was an extra column containing M or F to indicate the sex. 
The symbol means ‘AND’ and can be used to link several tests 
together. 



Calculating home expenses 



The next worked example shows how to use the Z88 to perform 
numerical calculations. It shows how you would analyse your monthly 
expenses, and discover what proportion of your income you were 
spending on each. 

You will learn how to: 

■ Enter numbers and expressions into a table 

■ Copy expressions to save typing 

■ Perform calculations 

■ Alter the format of the numbers 



Designing the table You are going to create a table which shows for each of the months 

January to May what your expenditure has been on your mortgage, 
food, car, gas and electricity, and telephone. 

At first sight it might appear that an awful lot of typing would be 
involved in setting up such a table. However, as you will see, all the 
repetition is carried out automatically for you by PipeDream and very 
little typing is actually needed. 



Moving around the document To set up the table of expenses you will need to be familiar with the 

procedure for moving the cursor between slots (or columns) in the 
document. Remember that you will need to use the following keys: 

0 to move up a line 

O to move down a line 

[shift! [tab] to move to the previous slot to the left 

[tab! to move to the next slot to the right 

O fTABl to move to the leftmost slot 
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Also, when you are at the left-hand edge of a slot, pressing <□ will move 
to the previous slot to the left, if there is one. 

When you are working with a document you can use the First Column, 
Last Column, Top of Column, or Bottom of Column commands on the 
CURSOR menu to move to the four edges of the document in a single 
operation. 



Labelling the table You are now going to set up the column and row labels for the table of 

expenses. 

Move the cursor to slot B1 and type the label Jan (for January). Likewise 
type Feb, March, and April in slots Cl to El to complete the column 
headings for the table. Later you could extend the table for a whole 
year’s figures. 

Now type the row labels for the different expense categories, as follows: 



In slot: 


Enter: 


A2 


Rates 


A3 


Mortgage 


A4 


Food 


A5 


Car 


A6 


Gas/El ect 



The table headings are now complete. Move the cursor back up to slot 
B2, and the table should appear as shown on the following screen: 
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Mortgage 
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Food 
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Car 
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Gas/Elect 


















58 



Section Two - Using PipeDieam 



Entering the rates 



Referring to slots 



The rates in the example are going to be £500 per half-year. This is 
going to be divided evenly over each month’s expenses, but you do not 
need to divide 500 by 6; PipeDream will do it for you. You only have to 
enter the expression 500/6 into slot B2 (the 7’ sign means divide). 

However, you first need to specify that this slot is to be an expression 
slot, so that whatever you type into it will be evaluated, and so that 
other slots on the table can refer to the result. To do this you give the 
Edit Expression command from the EDIT menu; alternatively you may 
find it more convenient to type OX which has the same effect. 

The slot B2 will be highlighted on the screen to show that you are 
editing an expression slot, and the cursor will move to the centre of the 
top line of the screen so that you can enter an expression. Type the 
expression 

500/6 

and press the IenterI key to enter it into slot B2. The number 83.33 will be 
displayed right -aligned in slot B2. 



You do not need to type the rates expression into the other slots in row 
2; you can simply indicate that you want the same value as slot B2 by 
typing the coordinates of that slot. 

Move to slot C2 and press OX to enter an expression. Then type 
B2 

and press IenterI . The value 83.33 will appear in slot C2. Likewise enter 
the expression B2 into slots D2 and E2. 

Effectively you have specified that you always want slots C2 to E2 to 
contain the same value as slot B2. So, for example, suppose you were 
granted a rates reduction to £400 per half-year. Move the cursor back to 
slot B2 and type OX to display the slot’s previous contents, 500/6. Delete 
them, by typing 

OD 
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and then type the new value: 

400/6 [enter] 

Not only will the value in B2 change to 66.67, hut slots C2 to E2 will also 
change, since they refer to this value. 



Replicating values Next you are going to enter the figure 200 for the four months’ mortgage 

payments. Type 200 into slot B3. If you forgot to type OX when entering 
the figure, the number will appear left-aligned just as you entered it. In 
this case, move the cursor back to the slot and press OX and then [enter] 
afterwards. 

You do not need to type the same value in slots C3 to E3; the Replicate 
command will do it automatically. 

Select the Replicate command from the BLOCKS menu, and press IenterI 
to execute it. Answer the prompts as follows, pressing O’ to move to the 
next line after entering B3: 

Range to copy from B3 

Range to copy to C3E3 

This says that you are going to replicate the value in slot B3 to the range 
of slots C3 to E3. Press IenterI to give the command, and the figure 
200 , 00 should appear across the entire row so that the table appears 
as shown: 
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, FI 


B, . . , 


c D 




4F t '“ "" ' 


1 

2 

3 

4 

5 

6 


Rates 

Mortgage 

Food 

Car 

Gas/El ect 


Jan 

1 


Feb 

66.67 
200 . 00 


March April 

66.67 66.67 

200.00 200,00 


66.67 
200 , 00 





Note that until you press the IenterI key you can alter the values you 
have typed for the ranges, moving between the two prompts with O 
and O. 
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Other expenses The expenses in the other categories will tend to vary each month. You 

can either type in the figures used in the example shown below, or use 
figures from your own experience. In either case complete the table, 
remembering to make each slot into an expression slot before you enter 
the figure, or if you forget, afterwards. 



m 














t 9 ■ 1 






...FI 


B 


C. , , 




E 




i 


■ 


Jan 


Feb 


Mar 


ch April 






2 


Rates 




86,67 


66,67 


66,67 


66.67 




3 


Mortgage 




200 . 00 


200 . 00 


200 . 00 


200 . 00 




4 


Food 




120,00 


130,00 


120,00 


130.00 




5 


Car 




40 . 00 


42.00 


44,00 


46,00 




6 


Gas/Elect 




100.00 


120,00 


110.00 


112.00 





Monthly totals You are now going to produce monthly totals for the expenses. Enter the 

label TOTAL into slot A7, and press {Tab] to move the cursor to slot B7. 

Now press OX, and enter the following expression: 

sum(B2 B6) 

Press the [enter! key, and PipeDream will perform the calculation and 
instantly display the sum of the figures in the range of slots B2 to B6; ie 
all the expenses for January. 

The function sum(B2 B6)isa convenient way of writing the equivalent 
expression 

B2+B3+B4+B5+B6 

where the slots to be added are all in a row, column, or rectangular 
table. 



Replicating slot references Just as you replicated the value 200.00 above, you can also replicate an 

expression across a range of slots. Where the expression contains 
references to other slots, as in this example s urn ( B2 B6 ) , the references 
will automatically be altered to reflect the change in position. 
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Replicate the expression you have just entered for slot B7 to slots C7 to 
E7 as follows. Select the Replicate command from the BLOCKS menu, 
and give the options as: 

Range to copy fron B7 

Range to copy to C7E7 

Press [enter! and totals will appear for each column. The Replicate 
command has automatically altered the range B2B6 to give the 
appropriate totals in columns C to E. 

If you now move the cursor to slot C7 you will see the expression in that 
slot displayed at the top left-hand side of the screen: 

sum<C2C6) 



Note that PipeDream removes unnecessary spaces when storing an 
expression. 



B7 sun<B2B6) 

R 


B, , 


C, , 


D, . 


E 


+( _ n'a'a a~a i 


2 Rates 


66.67 


66,67 


66.67 


66,67 




3 Mortgage 


200 . 00 


200 . 00 


200 . 00 


200 . 00 




4 Food 


120,00 


130.00 


120.00 


130.00 




5 Car 


40 , 00 


42.00 


44. 00 


46,00 




6 Gasr'Elect 


100,00 


120.00 


110.00 


112,00 




7 TOTRL ■ 


526 , 67 


558,67 


540.67 


554 . 67 





Percentage expenditures As a final illustration of the power of PipeDream in analysing figures, 

you are going to calculate the percentage expenditure represented by 
each of the categories in the table. 

First type the label 

Percentage 

in slot FI. 

Next find the total expenditure for the four months in the table. Move to 
slot F7 , press OX, and enter the expression 



sum(B7 E7) 
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Section Two - Using PipeDream 



Instead of typing the references B7 and E7, you can ‘point to’ each slot 
by moving the highlighted slot with the keys [tab], [shift! [tab] , <□, and O , 
and then give the Insert Reference command, OK, to enter the 
corresponding references, B7 and then E7, into the editing line. 

Now move to F2 and enter the following expression (which will be 
explained in a moment) : 

sum(B2 E2 ) / $ F$7 * 100 

Press IenterI to enter the expression. 

This expression is built up as follows: 

s u m ( B 2 E 2 ) is the total spent on rates for the four months . 

F7 is the overall total expenditure for the four months. The $ signs 
‘freeze’ the reference so that when the expression is replicated, the 
reference to F7 will remain the same. 

sum(B2 E 2 ) / $ F $ 7 is thus the proportion of the overall expenditure 
spent on rates. 

sum(B2 E 2 ) / $ F $ 7 * 100 expresses this proportion as a percentage. 

Now replicate this expression down the remaining slots in column F by 
giving the Replicate command from the BLOCKS menu, and entering 
the options as 

Range to copy fron F2 

Range to copy to F3 F6 

The appropriate percentages will be displayed against each category. 



F2 sun<B2E2V$F$7*100 

H B 

1 Jan Feb 

2 Rates 86,67 

3 Mortgage 200,00 

4 Food 120,00 

5 Car 40,00 

6 Gas^Elect 100,00 



C D 

March Flpril 

66.67 66,67 66,67 

200.00 200.00 200.00 

130.00 120.00 130,00 

42.00 44.00 46.00 

120.00 110.00 112,00 



.E IF 

Percentage 
■ 12.23 

36.69 
22.93 
7.89 
20.27 



d'a'a~a~a~* i 
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Changing the format 



When you first start using PipeDream, the results of ail expression slots 
are displayed with two decimal places, the most useful format for 
working with financial calculations (although values are stored 
internally with full accuracy). 

You can alter the display format for all expression slots in your 
document by changing the Decimal Places option on the Options Page 
menu, or for individual slots with the Decimal Places command on the 
LAYOUT menu. 

For example, the table would look tidier if the percentages were 
displayed with no decimal places. First, mark the block of slots 
containing the percentages with the following procedure: 

© Move the cursor to F2 and give the Mark Block command on the 
BLOCKS menu; alternatively, type OZ as shown on the list of key 
functions above the keyboard. 

© Move the cursor to F6 and give the Mark Block command again. 

The block containing slots F2 to F6 will now be highlighted. 

Now select the Decimal Places command from the LAYOUT menu. 
Reply to the prompts as follows: 

Number of decimal places 6 

Floating format No 



Press IenterI and the numbers will be displayed with no decimal places. 

You can also specify that certain characters, given on the Options Page, 
should be displayed before or after certain numbers in the document. By 
default, the trailing characters are set to '% ’, and the leading characters 
are set to 

To display a ‘%’ sign after the numbers in the marked block, give the 
Trailing Characters command from the LAYOUT menu. 

You can also display a sign before each value in the table. Mark the 
block of slots from B2 to E7 by moving the cursor to each of these slots 
in turn and typing OZ. Then give the Leading Characters command 
from the LAYOUT menu. 
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Finally, the column labels can be right-aligned. Mark slots B1 to FI with 
the Mark Block command, OZ, and give the Right Align command from 
the LAYOUT menu. 



Press OQ to clear the marked area, and the table will now appear as 
shown: 



F6 sun<B6E6)/$F$7*1 00 

FI B. , 


C. . 




E.. 


p t * A fl ATI 1 


1 


Jan 


Feb 


March 


April 
£66 , 67 


Percentage 

12* 


2 Rates 


£66 , 67 


£66.67 


£66.67 


3 Mortgage 


£200 . 00 


£200,00 


£200.00 


£200 , 00 


37* 


4 Food 


£120.00 


£130.00 


£120.00 


£130,00 


23* 


5 Car 


£40 . 00 


£42.00 


£44,00 


£46,00 


8* 


6 Gas/Elect 


£100,00 


£120.00 


£110.00 


£112.00 | 


20* 



What you have learnt These three examples have demonstrated how PipeDream can help you 

to write letters and design text documents (word processing), set up 
lists of information, sort them, retrieve the items you need (databases), 
and set up and perform calculations on tables of numerical or financial 
information (spreadsheets). 

For simplicity, each example focussed on one aspect of PipeDream’s 
capabilities. However, the real power of PipeDream comes in its ability 
to mix all three different functions in a single document. For example, 
the expense account could be incorporated into a letter to your bank 
manager, the name and address list could include financial information 
and calculations, or the party invitation could be automatically 
addressed to everyone on your name and address list. 

You are now in a position to start using PipeDream for your own 
applications, but to get the most out of its facilities you will probably 
want to read through the list of commands given in Section Five. You 
will then be able to refer back to it when your requirements of 
PipeDream become more advanced. 
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Section Three Using the Diary 



I 

I 

I This chapter will show how you can use the Z88 Diary application to 

organise your engagements, and plan your time. It demonstrates how 



■ Enter engagements into the Diary 

■ Search for and list out all engagements relating a particular thing 

■ Use the Diary with the Calendar popdown to find any date very 
quickly 



Entering the Diary Before using the Diary, make sure you have set the correct time and date 

on the Clock popdown, as described in Section One. 

You can enter the Diary in either of two equivalent ways, whichever you 
find most convenient: 



Either: go into the Index, by pressing the [index! key, and select the Diary 
from the APPLICATIONS list by pressing the 0 and -0 keys until the 
Diary item is highlighted. Then press the [enter] key to enter it. 

Or: type QD. You can do this from anywhere, even another application. 

Once you have made entries in the Diary, it will appear on the list of 
SUSPENDED ACTIVITIES in the Index, but there can only be one copy of 
the Diary. 

Type OCT to go to today’s date, and the Diary screen display similar to 
the diagram shown below will appear: 



I ARY 
LOCKS 

JRSOR 

DIT 

ILES 



lagjMaaasa 





oz 




TUESDAY 


1 7TH 




MARCH 




1 387 1 





INSERT 

MODE 
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This gives you a page for today’s date, onto which you can type infor- 
mation in any form you like. The information is stored permanently in 
the diary, arid you will be able to refer back to it on another occasion. 


Making a Diary entry 


Try typing the following appointments onto today’s page in the Diary, 
oressina the [tab] and IenterI kevs where indicated to lav out the lines 
neatly: 




Work: [tabI 10.00 Sales meeting IenterI 
Simon: [tab] 12.30 Pick ud from station [enter] 




You can actually lay out information in the Diary however you like, but it 
is a good idea to label your appointments, as in the example above, 
because you will then be able to locate everything in a particular 
category by searching for the appropriate label. An example of this is 
given below. 



Moving between days You can move between days in the Diary by typing 

□0 to go to the next day 
□0 to go to the previous day 

Try moving to the day after tomorrow, by typing m-G twice. 
Then enter the following appointment: 

Work: [tab] 11.00 Present report to Board [enter] 
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Searching for Diary entries 



The Diary provides a powerful Search command which enables you to 
find and list out all appointments in a particular category. 

As an illustration, the following example provides a list of all 
appointments relating to Work. 

First select the BLOCKS menu, by pressing the ImenO] key until blocks 
is highlighted on the menu bar at the left-hand side of the screen. Then 
move the cursor to highlight Search on the menu, and press IenterI to 
give the command. 

The following prompts will be displayed: 

STRING TO SEARCH FOR 



EQUATE UPPER AND LOWER CASE Yos 

SEARCH ONLY MARKED BLOCK No 

PRODUCE LIST No 

PRINT LIST NO 



Below the prompt string to search for type 

Work : 

Then press -0 three times to move the cursor to the line 

PRODUCE LIST No 

and type Y to alter the value of the option to Ye-s . 

Now press IenterI , since the other options are not relevant, and the 
appointments will be listed: 

Thursday 17th March 1987 
Work: 10.06 Sales meeting 

Saturday 19th March 1987 

Work: 11.66 Present report to board 

Of course, in your case the dates will be different, corresponding to the 
information you have used. 
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Using the Calendar and 
Diary together 



By calling the Calendar popdown from within the Diary, you can move 
quickly between different dates, and the Diary will then give the page 
for the date you have selected. 

For example, having forgotten a friend's birthday on the 17th March, you 
decide to make an entry in the Diary to make sure you do not forget it 
the following year. Use the following procedure to find the right day 
very quickly: 



TUESDAY 
1 7TH 
MARCH 
1 987 


1 

□ c 

► 


INSERT 

MODE 


Select Calendar 
popdown 
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Escape back to 
Diary application 



MARCH 1 988 



MON 


TUE 


WED 


THU 


FRI 


SAT 


SUN 




1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


1 1 


12 


13 


14 

21 


15 

22 


16 

23 


"SF 


18 

25 


19 

26 


20 

27 


28 


29 


30 


31 









You are now on the diary page for the same date one year later, and can 
type in the reminder. 



Refer to the following section for a full list of the Calendar operations. 



Section Four Using the popdowns 



Calculator - DR 
Calendar - DC 
Clock - OT 
Alarm - DA 
Filer - DF 
Panel - nS 
Import/Export -OX 
Index - fNDEXl or □! 



The Z88 popdowns are utility programs that you can make use of while 
you are working within another application, such as PipeDream, the 
Diary, or BBC BASIC. They pop down over your application screen, and 
disappear again when you press He] to return to the application. 

The following popdowns are provided in the Z88: 

Perform calculations 

Look up dates 

See the current time, and today's date 
Set alarms and reminders 
Perform operations with files 
Customise the Z88 to your requirements 

Transfer documents between the Z88 and other makes of computer 

Enter applications, popdowns, or suspended activities, and examine 
which cards are present 



Using popdowns You can either call a popdown by pressing the □ key combination given 

above, or from the Index as follows: 

Calling a popdown from the Index 

Highlight the popdown’s name on the APPLICATIONS list. You can 
move the bar highlighting items on this menu by pressing the 0 and O’ 
keys at the bottom right of the keyboard. If you move the bar too far, 
press 0 to go up again. Then press Ienter] to run the popdown you have 
selected. 





The Calculator - DR 



If you ever need to perform calculations while using the Z88 you can 
simply call up the Calculator popdown, even if you are in the middle of 
doing something else at the time: 



CALCULATOR 



0 . 00 



CONUERT 



1 C 1 e-arl 


DEL 


IStoM 


IRC IM 


+ 


7 


3 


9 




X 


L 


5 


1 6 


1 Y< >X 


- 


1 


2 


! 3 


s I q n 


/ 


0 


■ 


1 X 


F i X 


= 



Go i ions 
Mi I «S 
MPG 
flcrts 
I b 
oz 

DtjF 



<- 



Litres 
k n 

I / 1 OOk M 
Hectares 
k g 
9 

DegC 



The top line of the calculator displays the result of your calculation - 
initially 0.00 - and below that are the calculator keys. You can press 
these in either of two ways, depending on your preference. 

Either: Use the cursor keys 0 0 O O to highlight the operation you 
want, and then press IenterI to enter the selected key. 

Or: Type the Z88 key corresponding to the key you want, as listed on 
the next page. 
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Entering numbers 



Calculator Key 
Legend: 


Z88 Key 
Equivalent: 


Function: 


Clear 


C 


Clear 


DEL 


[DEL] 


Delete last keypress 


StoM 


s 


Store to memory 0 to 9 


RclM 


R 


Recall from memory 0 to 9 


0 to 9 


0 to 9 


Enter digit 






Decimal point 


Unit 


U 


Convert units (see below) 


Y<>x 


Y 


Swap y and x 


sign 


I 


Change sign 


Fix 


F 


Number of decimal places 


% 


% 


Percentage (see below) 


+ 


+ or P 


Plus 


X 


X, *, or T 


Times 


- 


- or M 


Minus 


/ 


/, \ , or D 


Divide 


= 


= 


Result 



Enter a number by selecting the digits with the cursor keys, and press 
[enter! ; or just type the number with the keys 0-9. You can use C or [del] 
to correct typing mistakes. Numbers can contain a decimal point, 
obtained by typing the full-stop key, and can be entered in scientific 
notation, as in 

1.27E6, entered as 1 . 2 7 E 6, which means 1.27 x 10 6 . 

7.1E-13, entered as 7 . 1 E I 1 3, which means 7.1 x 10- 13 

The two operands of an operation can be exchanged, before pressing =, 
by selecting the Y<>x operation, or pressing Y. For example, to find the 
reciprocal of a previous calculation, enter 

/ 1 Y = 

All calculations are performed to an accuracy of nine decimal places, and 
numbers can lie between 1E38 and IE-38. The Calculator displays 
Error if an error, such as 1/0, occurs. 
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Display format The format in which numbers are displayed can be altered with the Fix 

operation, which gives the prompt 

Fix"? 

Typing a number between 0 and 8 will fix the number of decimal places 
displayed to the specified number; the initial value is 2. Typing 9 will 
give free format. 



Constants Entering a number, followed by one of the arithmetic keys pressed 

twice, stores the operation as a constant operation and displays the 
operator with K at the top right-hand comer of the screen. 

For example, entering 

1.15 * * 

sets up constant multiplication by 1.15, and displays * K ; entering 

1000 = 

then gives the result 1150.00, and 

2000 = 

gives the result 2300.00. 



Storing and Recalling You can store a result for use later in a calculation with the StoM and 

RclM operations. 

To store a result, select the StoM operation (or type S). The prompt 

St- O M "? 

will be given, to which you should give a register number by typing a 
digit from 0 to 9. Up to ten different results can be stored, one in each 
register. 

You can also add a result into a register, subtract a result from a 
register, multiply a register by a result, or divide a register by a result, 




The Calculator 



73 



by giving the StoM operation followed by or T respectively, 

followed by the register 0 to 9. 

You can cancel a store operation in the middle by pressing [esc] . 

For example, 

1.2 S 9 

stores 1.2 in register 9, and 

3.56 S-9 

subtracts 3.56 from the same register. Finally 
R 9 

, recalls the result from register 9. 



Percentages The '%’ key works in conjunction with one of the other keys '*’, 7’, '+', or 

to calculate percentages, and to add or subtract a given percentage to 
or from a number. The following examples illustrate each of these cases. 

To find 12% of 1500 enter 

1500 * 12 l 

To express 660/880 as a percentage, enter 

660 / 880 l 

To add 15% on to 125 enter 

125 * 15 l + 

Likewise, to discount 125 by 15% enter 



125 * 15 1 
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Section Four - Using the popdowns 



Converting units 



You can convert any result between the pairs of units displayed on the 
CONVERT menu by selecting the Unit operation. 

Highli ght th e unit you want to convert to using the cursor keys, and 
press IenterI to perform the conversion. For example, to convert from 
Litres to Gallons highlight Gallons, and to convert from Gallons to Litres 
highlight Litres. To exit from the CONVERT menu press [esc] . 




The Calendar - DC 



The Calendar provides a convenient tool for planning your 
engagements, particularly when you want to look up dates quickly 
without leaving the application you are currently working on. Calhng the 
Calendar displays the page for the current month, or the month you last 
looked at: 



MARCH 1 987 



MON 


TUE 


WED 


THU 


FR I 


SFiT 


SUN 


2 


3 


4 


5 


6 


7 


1 

8 


9 


10 


1 1 


12 


13 


14 


15 


16 


■MP 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 



23 ^13 
30 31 



You use the cursor keys, in combination with the [shiftI and O keys, to 
move about within the calendar as follows: 



Ci previous day 

ft previous week 

IshiftI 0 previous month 
oft previous year 



O next day 

■0 next week 

IshiftI ft next month 

<>ft next year 



If necessary, the calendar will automatically turn a page to the next or 
previous month. 

The Calendar is accurate back to the year 1753 (when the Gregorian 
calendar was accepted in England) and so has historical applications in 
addition to its obvious business uses. 



76 



Section Four - Using the popdowns 



Searching for a day 



Active days 



You can also use the Calendar to go immediately to any date in any year. 
Press [enterI , and the prompt 

Look for: 17/03/1987 

will be displayed, with today’s date initially displayed. Type in the date 
you are searching for, and press the IenterI key. The cursor will move to 
the specified day. 

The date can also be entered in the form 

17 mar 1987 

if you find this more convenient. The Z88 defaults to the twentieth 
century, so 17 mar 87 is equivalent to 17 mar 1987. 



If the Calendar popdown is called from the Diary application, days 
containing information in the Diary will be identified on the Calendar 
with a pointer against the date 

► 17 

Such active days can be found in the Calendar very quickly with the 
commands 

□ O previous active day □ i=> next active day 



The Clock - CIT 



The Clock popdown can be called whenever you need to see the correct 
time or date. The time is displayed in 24-hour format, and is accurate to 
within a few seconds per day. To set the time and date, see the details 
given in Set the clock, p. 9. 



CLOCK 



Tuesday 
17th March 
1987 

11:44:53 



EXIT 



Press [esc] to return to the current application. 

Because you may be using the Clock popdown to time something, the 
Z88 will not switch off after the timeout period if the clock is displayed 
on the screen. 




The Alarm - DA 



The Alarm popdown can be used to make your Z88 remind you of 
important events or appointments, or simply to wake you up in the 
morning. Any number of alarms can be set up, and for each alarm you 
can specify the following information: 

DATE 

The date on which the first alarm will occur. For a new alarm this is 
initially set to the current date, or if the alarm is called from the Calendar 
or Diary, the Calendar or Diary date. 

TIME 

The time at which the alarm will occur. For a new alarm this is set to the 
current time, but you will usually alter it to the required alarm time. All 
times in the Alarm are given in 24-hour format. 

REASON/COMMAND 

For each alarm you can specify a message of up to 23 characters, or a 
CLI command string which will be executed to cause something to 
happen; see below. 

To set an alarm, press IenterI . The alarms you have set up will become 
active as soon as you exit from the popdown by pressing Use) . 

Note that the Z88 will not switch off automatically while the alarm 
popdown is on the screen. 



Alarm options Each alarm can also have the following optional settings: 

Bell: can be on or off , determining whether the Z88 bleeper sounds 
when the alarm is activated. 

Alarm type: normally rlrrm. This can be altered to execute to allow a 
command, in the person for rlrrm field, to be executed when the 
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Clearing alarms 



alarm is activated. Thus you could, for example, cause the Diary to be 
entered and a line of text to be typed in automatically on an alarm: 

#D ! CT Urgent message 

For more Information on executing commands, see CLI files, p. 179. 

Repeat every, normally set to never , so that an alarm will occur just 
once, at the specified time and date. The repeat rate can be altered to 
one of the following to obtain a repeating alarm: 

YERR, MONTH, WEEK, DRY, HOUR, M I NUTE , SECOND 

You can move between these options with IshiftI 0 and IshiftI 0 ; 
pressing 0 or O then increases or decreases the number of the unit 
selected. You can thus specify every 3 hours, for example. 

No. of times : specifies the number of times that the alarm will be 
repeated before being cancelled. It is initially set to never, so that the 
alarm will occur just once. It can be set to forever by pressing O, or a 
number from one upwards by pressing 0 ■ Holding the IshiftI key down 
while pressing 0 or 0 will increase or decrease the number in tens, 
and O-ft and O-0> will change it in hundreds. 

By setting these fields appropriately, you can obtain almost every 
possible alarm setting. For example, to cause an alarm to occur on the 
3rd March, 3rd April, and 3rd May, at 12.00, set 

drte 3 Mar 1987 repert every 1 MONTH 

TIME 12.00 NO. OF TIMES 3 

Note: Do not set the alarm to repeat every second for ever. You will not 
be able to cancel it without doing a soft reset. 



To clear an alarm, select it with the cursor keys O or O on the list of 
alarms, select clerr rlrrm with <□ and i=>, and press IenterI . With a 
repeating alarm this just clears the present alarm; use clerr rlrrm 
twice to remove a repeating alarm completely. 

If an alarm occurs while the Z88 is turned off, the alarm will sound and 
the Z88 will be turned on in LOCK OUT state to prevent accidental key- 
presses. To clear this state turn the Z88 off and then on again in the 
usual way, by pressing both IshiftI keys. 




The Filer - DF 



With extension RAM and EPROM cards fitted, you will have the ability 
to store many documents in your Z88. The Filer provides everything you 
will need for organising these; in particular it allows you to: 

■ Obtain a list ( catalogue ) of all your files, or the files in the optional 
EPROM card (Catalogue Files and Catalogue EPROM). 

■ Move files to and from an EPROM, which provides permanent 
storage on a removable card in slot 3 of the Z88 (Save to EPROM and 
Fetch from EPROM). 

■ Change the names of files within the filing system (Rename). 

■ Make additional copies of files (Copy), or remove files completely 
(Erase). 

Other commands, for more advanced use of the Filer, are explained in 
the Filer Reference section. 

When you have finished using the Filer, press (esc] to return to the 
original application. 

Hierarchical structure 

The Z88 filing system is a hierarchical filing system. This means that 
you can group files together within 'directories’. This facility is akin to 
keeping similar documents in a folder within a filing cabinet, and is of 
great assistance in keeping a large number of files orderly. However, for 
simple use of the filing system you will not need to use these facilities; 
see the Filer Reference section for a full description. 

Note: With Operating Systems up to and including 3.0 it is important 
that you only exit the Filer by pressing (esc) . In particular, if you are 
using Catalogue Files (OCF) or Catalogue EPROM (OCE) and you exit 
the Filer in the middle of the operation by using (index! or □ followed by a 
letter, then one of the files can become marked as ‘IN USE’, and you will 
not be able to access it without performing a soft reset. 
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Entering the Filer The Filer display consists of two windows; a COMMANDS window, and 

a DIRECTORY window: 



Commands Catalogue window Directory 

Allows a Filer command to Lists all the files and directories Shows the currently-selected 




Lists the Filer Marker indicates files that Directory names are in Filenames can be upper 

commands. have been selected. small capitals. and lower case 



File names Each file or directory in the filing system has a name of up to twelve 

letters or digits. This can be followed by a full stop and up to three 
further letters or digits called the extension, and is normally used to 
describe the type of the file. Thus a BASIC program could be saved as 

game.bas 

where b a s is an extension used for all BASIC programs. 

Upper- and lower-case letters are treated as equivalent in hie names. In 
the catalogue window directories are displayed in a small typeface. 

Specifying devices 

When saving and loading files to and from applications, such as 
PipeDream, you will normally just give the file name and extension, if 
there is one. However, the Filer keeps a fuller description of where the 
file is in the system, including which RAM card it is on (the device), and 
several of the Filer commands will show this full form of the hie name. 
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Section Four - Using the popdowns 



Giving Filer commands 



The full form of a file name is 
■.DEVICE/ filename 

The most useful options for DEVICE are: 

: RAM . 0 RAM in slot 0 (internal memory) 

: RAM . 1 to .-RAM. 3 RAM in slots 1 to 3 (external memory) 

A full list is given in the Filer Reference section. 

* can he used in any part of a file name to match any characters; thus 

game* 

represents any file name beginning with game, and 
: RAM.* 

represents all the RAM in the Z88. 



You can give filer commands in one of three ways, depending which you 

find most convenient: 

© Select the command from the Filer COMMANDS list, using the ft 
and O keys. The list of commands will scroll up if you move the 
cursor below the bottom of the screen. Then press Iente rI to give the 
command. 

© Select the command from the COMMANDS menu with the cursor 
keys, and press IenterI to give the command. 

® Give the O key sequence for the command, as listed below. 
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COMMANDS menu 



Press [menu' to see the COMMANDS menu: 



FILER 


Catalogue F il es 


oCF 


Create Directory 


«CD 


Catalogue EPROM 


OCE 




oz 


COMMANDS 


Copy 


oCO 


Select Directory 


«SI 


Save to EPROM 


OES 


ROMANCE 






Rename 


ORE 


Up Directory 


SHIFT ■fr 


Fetch from EPROM 


OEF 


0- <> -0- V 






Erase 


OER 


Down Directory 


SHIFT * 


Select Dewice 


oSU 


SELECT 






Execute 


OEX 


Cursor Right 


■i> 


T ree Copy 


oTC 








Select First File 


iifiiia 


Cursor Left 


<> 


Name Match 


«NM 


ACTION 






Select Extra File 


SHIFT Ulilia 


Cursor Up 








■ESCM 










Cursor Down 


-0 






RESUME 





Selecting files The Filer provides two ways of identifying the files you wish to operate 

on. 

Either: Type the file name after the Filer prompt 
Name : I 

Or: Select the file or files in the catalogue window, as described below. 

Select First File - fENTBtl or [ta|] 

Select Extra File - [SHiFTlfENTffll or (ta! 

Select the first file by highlighting the file name using the cursor keys, 
and press IenterI (or (tab]). You can select further files, if required for an 
operation that can be performed on several files at once (eg Erase), 
using [shift! (enter! (or (tab] again). 

When selected, files are indicated by a marker to the left of the file name 
in the catalogue window, as shown in the example on p. 81. 
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Section Four - Using the popdowns 



Filer commands The commands for simple use of the Filer are listed below; for full use of 

the hierarchical directory structure, see Section Seven - Filer Reference, 
p. 175 

Catalogue Files - OCF 

Gives fuller information about a specified list of files. The subset of files 
to be catalogued is specified after the prompt 

Name : I 
Reply as follows: 

[enter! catalogues all files (in the current directory) 

f r e d * catalogues all files beginning with f r e d 

* . b a s catalogues all files with abas extension 

Each file will be listed as: 

Creation time and date Last updated time and date Size in characters 

Today 17:42:54 Today 17:42:54 1254 

01 - Jun-1 987 17:41:17 Today 14:32:50 13112 

02- Jun-1 987 12:27:43 02-Jun-1987 12:27:43 827 

(The last updated time and date are only relevant if OPENUP is used 
from BASIC.) If the file is open at the time it is catalogued, the size will 
not be shown. 

When you catalogue or save to a blank EPROM, the display will go blank 
for a few seconds while the EPROM is checked. 

Catalogue EPROM - OCE 

Gives a list of information on all files in an EPROM card fitted in slot 3. 
The directories and file names will be given to show where the files 
originally came from. 

Save to EPROM - OES 

Copies files from the filing system to an EPROM card fitted in slot 3. The 
file or files to be saved can either be selected as already described, or 
specified after the prompt 



File name 

letter, txt 
novel , txt 
yame , bas 



Name : I 
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Note that while a file is being saved to EPROM the screen will blank 
intermittently until saving is completed, when the Z88 will bleep. 

Fetch from EPROM - OEF 

Copies files from EPROM card in slot 3 back to the filing system. Gives 
the prompts 

Source : 

Destination : 

Source: specifies the name of the file in the EPROM. 

Destination: gives the name it is to be saved as in the destination filing 
system. It is initially set to the same as the source name, but you can 
edit it if you want to save the file under a different name. 

Copy -OCO 

Makes a second copy of a file. Gives the prompt 
Nane : 

allowing you to specify the file name to be copied, followed by the 
prompt 

New narco : 

for the name of the copy. 

Multiple files (selected in the catalogue window) can be merged into a 
single file with the Copy command; they will be appended in the order 
in which they were selected. 

Rename - ORE 

Allows the name of a file to be altered. Gives the prompts 



H arc e ; 
New narce : 



86 



Section Four - Using the popdowns 



For example, to change the name of a file from ga me . b a s to 
ol dversi on you would specify 

Name : game.bas 
New name : oldversion 

Note that you cannot use the Rename command to move a file from one 
directory or device to another. The new name must be a simple file 
name; devices and path names are not permitted. 

Erase - OER 

Allows one or more files to be removed from the filing system. Gives the 
prompt 

Name : 

followed by the prompt 
Confirm each file ? Ves 



Pressing IenterI will prompt for each file you have selected to be erased, 
so allowing you to change your decision for any particular file. 
Alternatively, changing the option to N o by typing N will erase all the 
selected files without further prompting. 

You will not be permitted to erase a file which is in use; for example, a 
directory containing other files, or an open BASIC file. 

Files can only be erased from the EPROM with the ultra-violet EPROM 
eraser. 

Note that because parts of an erased file may still be present, you should 
not rely on the Erase command for disposing of confidential information 
from the system. 

Advanced Filer commands 

The remaining Filer commands are for advanced use of the Filer, and the 
hierarchical directory structure; these are explained in the Section 
Seven - Filer Reference, p. 175. 




The Panel - DS 



The Panel popdown allows you to set up aspects of the Z88’s operation 
to suit your own preferences. You can alter the rate at which keys on the 
keyboard auto-repeat when you hold them down, the time after which 
the Z88 will automatically switch off, the default device and directory 
used by the Filer, and the parameters for the serial interface. 

You can call up the panel by typing nS (for Settings). 



Altering the panel To alter an option on the panel, first select it by moving the cursor to the 

appropriate line with the cursor keys 0 , 0 , 0 , and <□ . Then type in the 
new value for the option, and press [enter! . 

In the case of options with alternative values you can also select 
between the alternatives by giving the Next Option command, <> J, or 
you can specify the option you want by typing the option’s first letter. 

You can save a particular set of panel settings in a panel file, using the 
Save command on the FILES menu. Selecting the New command on the 
FILES menu returns the settings to their initial values. 



Panel options For each of the following options the initial default value is shown in 

brackets. 

Note that options marked t affect only the state of new activities, and 
existing activities retain their original settings. 

Keyboard options 

Auto-repeat rate (6): determines the rate at which keys auto-repeat 
when held down continuously. Smaller values increase the repeat rate. 
A value of 0 gives no auto-repeat. 

Keyclick (No): altering the option to Ye s gives an audible bleep at each 
keypress, to provide additional feedback during touch-typing. 
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t Insert/Overtype (Insert): in Insert mode text typed at the keyboard is 
inserted at the cursor position, and subsequent text on the line moves to 
the right to make space for the new text. Some typists prefer Overtype 
mode, in which text types over any text previously on the line. To insert 
text in Overtype mode you need to make a gap in the line with the 
Insert Character command OU first. 

Filer options 

t Default device (:RAM.O): the device to and from which files are saved 
and loaded, which is set to the internal RAM memory filing system by 
default. It can also be set to :RAM.l, :RAM.2, or :RAM.3, corresponding 
to the three RAM cards. 

t Default directory, allows a path of one or more directories, which should 
already exist, to be specified for all filing-system operations. By default 
the top-level directory is selected. 

Machine options 

Timeout (mins) (5): determines the time after which the Z88 will switch 
off if nothing is typed at the keyboard; a value of 0 disables timeout. 
Setting the timeout to 2 minutes will extend the effective battery life of 
the Z88 (1 minute is possible but not recommended for normal use). 

Sound (Yes): allows the internal sound system to be switched off. 

Map (Yes): allows the PipeDream page map display to be turned off if 
not required. Typing and editing will be marginally faster when the map 
is disabled. 

Map size (80): allows the size of the map to be altered up to a maximum 
size of 92 characters across, or 255 characters across on a Z88 with at 
least 128K in card slot 1. Reducing the size of the map allows a larger 
text display width to be used in PipeDream. 

Date format (European): determines the format for all dates in the Z88; 
the default date format is European, so that dates are recognised in the 
form: 

day/month/year 

The option can be changed to American to work with the format 
month/day/year 
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Serial port parameters 

j_ Transmit baud rate (9600) /Receive baud rate (9600): can both be set to 
any of the following values: 



75, 300, 600, 1200, 2400, 9600, 19200, 3§4fl0 



1 . . Parity (None): can be set to None, Space, Mark, Odd, or Even. The 
number of data bits is ft if None is ^gcifipri or 7 otherwise. 

3 , Xon/Xoff (Yes): determines whether the serial communication protocol 
uses Xon/Xoff. 






The number of start and stop bits is fixed as follows: 



5 



Transmit: 1 start bit, 2 stop bits 
Receive: 1 start bit, 1 stop bit. 






V- Note: In versions of the Operating System up to and including 3.0 ODD 
and EVEN parity settings do not result in correct behaviour. 




Import/Export - OX 



The Import/Export popdown enables you to transfer files between the 
Z88 and other makes of computer. It communicates with the other 
computer through the serial port on the right-hand side of the machine. 
To use Import/Export you will need an Import/Export program for the 
other computer, and a connecting lead. Follow the directions supplied 
with this for a detailed explanation. 

Details of the serial port connections are given in Appendix B. 



Using Import/Export The serial parameters should be set up in the Panel before running 

Import/Export. Also run the program on the machine you wish to 
communicate with. 



The program recognises the following commands, which are given by 
typing the first letter of the command: 

S)end file Prompts for the name of the file to be transmitted, and then transmits 
the name and file to the receiving computer. Wildcards are accepted in 
the file name. 



R)eceive file Prompts for a file name; press [enter! to receive a file and use its 
transmitted name, or type a name to rename the received file. 

B)atch receive Receives a sequence of named files, terminated by an end batch code. 

E)nd batch Sends an end batch code (ESC Z). 

To send a batch of files use the following procedure: 

© Give the Batch receive command on the receiving computer 

© Send each file with a Send file command (or give a wildcard in the 
file name) 

® Give an End batch command. 
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Import/Export protocol 



The Import/Export protocol is given here for programmers who want to 
interface the Z88 to a computer by writing their own interface software. 



Control sequences 



Sequence 


Function 


ESC N 


Start of file name 


ESC F 


Start of file/end of file name 


ESC E 


End of file 


ESC Z 


End of file or end of list of files 


ESC B x x 


Where x x is two ASCII digits representing a hex 
byte. For example, the byte &A9 is transmitted with 
ESC B A 9. 


XON = & 1 1 


Receiver sends to transmitter to restart flow. 


XOFF = & 1 3 


Receiver sends to transmitter to stop flow. 



Note that all the characters after the ESC code must be in upper-case 
ASCII. 

Transfer protocol 

First file, and subsequent files: 

ESC N filename ESC F data ESC E 

Last file: 

ESC N filename ESC F data ESC Z 

where data is a sequence of characters in the range &20 to &7E. Codes 
in the range &00 to &1F and &7F to &FF should be transmitted using 
the ESC B prefix. 

Import/Export will give aS us pended message if a battery low is 
flagged while sending or receiving, or if the Z88 is switched off or the 
flap is opened. In this case you must repeat the transfer. 



The filename can be omitted. 





The Index - □! 



The Index popdown allows you to 

■ Enter popdowns or applications. 

■ Start PipeDream (or BBC BASIC) with a new, blank, document (or 
program). 

■ Obtain a list of all the suspended activities you have in the Z88, and 
remove activities you no longer need. 

■ Insert and remove RAM, ROM, or EPROM cards. 



The Index screen 



APPLICATIONS 



YOUR REF. 



SUSPENDED ACTIVITIES 



CARDS 



Allows you to select and enter 
an application or popdown. 



Name given to identify a 
suspended activity 



Lists the activities being 
kept in the machine. 



/ 



/ 



Indicates activities using 
an application card, and 
the associated slot number 



/ 



COMMANDS 



aasEsnHs 

NAME A 

■jJJHJPl 

Pi peDrean 
BASIC 

Cal cul ator 
Cal endar 
Clock 



□p 

□B 

□ R 

□ C 

□ T 



/ 




9 


/ 




SUSPENDED 


i mm 




YOUR RE 


RPPLICRT ION 


WHEN SUS 


PENDED CRPD/ 


Report 

Epson 


Diary 
P ipeCrean 
Pr interEd 
C0t1t188 


Today 

Yesterday 

Yesterday 

Yesterday 


T TT277Z1 f 

10:13:35 / 

09:06:19 ' 

08:56:19 2 



OZ 









(A 
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Entering an application 


To enter an application, or a popdown, select its name on the 
APPLICATIONS list by moving the highlighting bar up and down with 
the cursor keys 0 and O’, and press the (enterI key: 




Diary 


□D 




PipeDream 


□P 




BASIC 


□B 




Calculator 


□R 




Calendar 


□C 




Clock 


□T 




Alarm 


□A 


i 


Filer 


□F 




PrinterEd 


□E 




Panel 


□S 




Terminal 


□V 




Imp-Export 


□X 




When the bar reaches the bottom of the screen, the list scrolls up to 
show the remaining options. 




Entering PipeDream (or BBC BASIC) from the Index APPLICATIONS list 
creates a new, blank document (or program). 



Suspended activities The SUSPENDED ACTIVITIES list shows the following information for 

each suspended activity: 






I Heading 

I YOUR REF, 



Meaning 

The name given to the document (with the 
PipeDream OFC or OFL commands, the Diary or 
PrinterEd OFC, OFS, or OFL commands, or the 
BASIC *NAME command) 



RPPL I CRT I ON 



The application name 



when suspended The time and date the document was suspended 



CRRDS 



The number of the card slot, for activities using 

an application card 



There can be more than one PipeDream and BBC BASIC suspended 
activity, but only one for each of the other applications. 
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Re-entering a suspended activity 

To re-enter a suspended activity, select it by moving the highlighting 
bar across with the cursor keys, and then press the en~e= key. 
Alternatively, pressing dP or nB repeatedly will enter each PipeDream 
or BBC BASIC activity in turn. 

Killing activities - OKILL 

To kill a suspended activity, select it on the SUSPENDED ACTIVITIES 
list with the cursor, and type OKILL. The activity will be removed from 
the list, and the document (or program) associated with it will be lost. 
OPURGE is equivalent to a soft reset, which kills all suspended 
activities, and should therefore be used with great caution. 



Cards There are three types of card for use with the Z88: 

RAM cards are for storing your own information. 

Application cards, referred to as ROM cards, are used for plug-in 
programs and help text. 

EPROM cards allow you to write information once only, but retain it 
even when removed from the machine thus providing a secure way of 
saving your data. 

Card information - OCARD 

The OCARD command, on the Index COMMANDS menu, shows the 
type and size of the card in each slot. 

Inserting or removing cards 

Cards should only be inserted or removed with the Z88 switched on. 

First enter the Index. Then open the perspex flap at the front of the 
machine. Check that the screen goes blank. The computer should bleep 
once as you open the flap. The card can then be pushed in or pulled out 
The label on the end of the card should be upnght when you push the 
card home. When you have completed the operation, push the perspex 
flap back into position. 
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Card errors 

Errors which occur during the insertion or removal of cards are 
displayed in the OZ position at the left-hand side of the screen. 

A H3H message is given if a RAM card is removed, indicating that a soft 
reset is necessary. 

If you remove an application card which a suspended activity is using, 
the Z88 will give a continuous tone and flash card until the card is 
replaced. The suspended activity should be removed with OKILL before 
trying again. 

An i ndex message is given, together with a continuous tone, if you 
have attempted to remove an application card while not in the Index. 



RAM Cards RAM cards allow you to store more data in the Z8 8. RAM cards are 

available in different sizes; the 32K RAM approximately doubles the 
storage of the Z88, providing space for an extra 32,000 characters. The 
128K RAM increases memory even more, allowing you to use the Z88 to 
store very large documents, diaries, or programs. 

It is recommended that you avoid using slot 3 for RAM cards because 
they draw more current in slot 3 than in slots 1 and 2, and slot 3 would 
then not be available for EPROM cards. 

Expansion facilities 

Some additional facilities will be available on a Z88 which has a RAM 
card of at least 128K in slot 1: 



Less than 128K in slot 1 


128K or more in slot 1 


Map limited to 92 pixels 
BASIC workspace 8K 


Map can be up to 255 pixels 
BASIC workspace 40K 



RAM card FAIL 



If you do accidentally remove a RAM card, a U±U message will appear 
and a soft reset will be necessary. The Z88 will attempt to keep all the 
files in the remaining RAM. If you need to change a RAM card you must 
therefore save all your important data into another RAM card, EPROM, 




96 



Section Four - Using the popdowns 



or transfer your files to another computer using the Import/Export 
programs. 

Since the RAM cards draw their power from the Z88, the contents will 
be lost if the Z88 loses its power. 

Using the Filer with extra RAM 

Files are normally stored in the internal memory. To make the Z88 use 
the external card you need to set the DEVICE to : RAM . n where n is the 
slot number (shown in white letters on the flap). The device used by 
new applications is determined by the Panel setting. 

For example, if you have a RAM card in slot 1, set the Panel: 

Default Device :RRM.1 

Each existing application will store the device it is using. To alter these, 
first go into the application, and then use the Select Device in the Filer 
to change the device setting for each application you want to use the 
new RAM card. 



EPROM cards EPROM cards can be inserted or removed at any time, except when you 

are actually reading or writing to EPROM. The EPROM card must go into 
the right-hand slot, labelled 3. 

When you catalogue or save to a blank EPROM, the display will go blank 
for a few seconds while the EPROM is checked. 

EPROM cards provide the best method of archiving valuable data files or 
programs. Once the EPROM is full, the recommended way to erase it (if 
required) is to use the ultra-violet EPROM ERASER from Cambridge 
Computer Ltd. 

Note that an EPROM card should be removed before restoring power to 
a Z88 in any of the following circumstances, or data may be corrupted: 
after it has been left unpowered; after it has been left for some weeks so 
that the batteries have failed; after a persistent battery low sign; or 
when changing the batteries. 

Never leave EPROM cards where sunlight can shine onto the round 
window. Significant exposure to strong direct sunlight of more than ten 
minutes may cause loss of data. 
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EPROM eraser 

The EPROM eraser will erase all the data stored in the EPROM by 
exposing the integrated circuit through the round window in the card to 
ultra-violet light. 

WARNING 

If the internal light can be seen when there is no card present the 
EPROM eraser is faulty and should be returned. 

The EPROM eraser produces an intense ultra-violet light which can only 
be activated by inserting a Z88 memory card into the eraser; this safety 
feature prevents any escape of ultra-violet light. 

REMOVE FROM MAINS SUPPLY WHEN NOT IN USE. 

Never touch the ultra-violet light source. It gets hot in use and may 
cause burns; also it is made of quartz and will cloud over due to 
moisture from the skin. 

To erase an EPROM 

© Connect the eraser to the domestic mains supply. The plug should 
be fitted with either a 1 Amp or a 3 Amp fuse. 

© Fully insert the EPROM card into the slot on the front of the eraser, 
with the round hole uppermost. The card is correctly inserted if the 
white label on the end of the card is visible and the printing "32K 
EPROM” or “128K EPROM” is upside down. 

(D The action of inserting the card switches the eraser on. The yellow 
indicator light on top of the eraser should light and the EPROM will 
be exposed to ultra-violet light for approximately twenty minutes. 
After this time the ultra-violet light is automatically switched off 
and the yellow light will go out. 

© After the yellow light goes out, you can remove the card from the 
eraser. DO NOT REMOVE THE EPROM BEFORE THE YELLOW 
LIGHT IS OUT. The EPROM card should now be blank and ready for 
re-use. Removing the card resets the timer, so to erase another card, 
simply insert it; the yellow indicator light will again be illuminated, 
and the process can be repeated. 
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Application cards 



The ultra-violet light source decreases in efficiency with use and 
eventually a single 20-minute exposure may not completely erase all the 
data in the EPROM. In this case it may be a good idea to repeat the 
process a second time to be absolutely sure that it is thoroughly erased. 

There is no means of erasing selected individual parts of data from the 
EPROM. When the EPROM is exposed to the ultra-violet source all data 
is affected in the same way. 



Application cards, containing help text, an application, or both, can be 
inserted into any of the three slots. Note that you must first go to the 
Index before opening the card flap and inserting the card. When you 
close the perspex flap, the Z88 should register the new card. 

Before removing an Application card, activities using the card must be 
killed. To do this, enter the Index, and examine the SUSPENDED 
ACTIVITIES window to see if the number of the card you want to 
remove appears in the CARDS column. Any activity with the Application 
slot number next to it is using the card, and should be killed with the 
OKILL command. The card can then be removed. 

Following a cord message, you must replace the card in the same slot 
and then OKILL any applications which are using the card. Following an 
i ndex message, you must return the card to its original slot and close 
the flap. You must then enter the Index and remove the card in the usual 
way. 
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Section Five PipeDream reference 



This section describes all of the PipeDream commands that are available 
in each menu. To understand this chapter, you should already be 
familiar with the basic concepts of using PipeDream described in 

Section Two - Using PipeDream. 

All commands can be typed directly from the keyboard, as well as 
chosen from the appropriate menu. The keyboard equivalent for each 
command is shown to the right of the command name in the menu. For 
example, the Replicate command on the BLOCKS menu appears as 

Replicate oBRE 

This means that you can give the Replicate command by typing the <> 
key followed by the keys B R E. Note that the letters do not need to be 
in capitals: Obr e has the same effect. Also, you can hold down the O 
key while typing the letter keys if you prefer. 

When, as in this example, the command equivalent is a sequence of two 
or three letters, the first letter will usually be the first letter of the menu 
name. For frequently-used commands, the key equivalent is a single 
letter with the O key (in a very few cases the □ key). For example, the 
Mark Block command on the BLOCKS menu has the equivalent OZ. 

Note that in the following screen diagrams the highlighting bar has 
been omitted for clarity. 



Setting the options Some commands present you with a table of options which allow you to 

set up the command to your requirements. 

To begin with, the cursor is positioned next to the first option; the 
cursor keys can be used as normal to move up and down the list. 

Many of the options have only two possible alternatives: Ye- s and No . 
You can change the value shown either by typing Y or N as appropriate, 
or by using the Next Option command, O J, which alternates between 
the available values. In the case of options which take specific values, 
such as Page Length, Next Option restores the default value. 



Operations on blocks of slots - BLOCKS 



PI REDREAM 


Mark Block 


«Z 


Search 


oBSE 


Word Count 


oBUIC 


iprcrm 


E3 


■ Hill 


Clear Mark 


oQ 


Replace 


oBRP 


Neu 


oBNEU 


ROMANCE 




CURSOR 


Copy 


oBC 


Next Match 


oBNM 


Recalculate 


«R 


« « 3- V- 


asiS 


EDIT 


Move 


oBM 










SELECT 




FILES 


Delete 


oBD 












WKm 


LRYOUT 


Sort 


oBSO 










ACTION 




ORTIONS 


Replicate 


oBRE 












■i 


PRINT 














RESUME 


■ 



The commands on the BLOCKS menu enable you to manipulate 
documents to control exactly which areas are affected by a particular 
operation. A block can include anything from a single slot to a complete 
document. 



Marking Before giving any block command you identify the slots you wish to 

operate on using the Mark Block command. You can mark a single slot, 
a row of slots, a column of slots, or a rectangular block of slots spanning 
several rows and columns. 

You identify which block of slots you want to operate on by giving the 
Mark Block command at the top left-hand comer and bottom right-hand 
comer of the block. After giving the two Mark Block commands, all the 
selected slots in the block will be shown highlighted on the screen. 

Mark Block - 07 

Marks a single slot, or the top left-hand corner and bottom right-hand 
comer of a rectangular block of slots, to identify the slots to be operated 
on by subsequent block commands. 

Clear Marks -OQ. 

Clears any marked block previously set up with the Mark Block 
command. 
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Replicating slots 



Replicate - OBRE 

Reproduces the contents of a slot, or block of slots, in any part of the 
document. The following options are displayed: 

Range to copy from 
Range to copy to 

Each range is a block of slots identified by specifying the coordinates of 
its top left-hand corner and bottom right-hand comer. If necessary, extra 
rows and/or columns are created in the document to accommodate the 
new slots. 

The ranges can be one of the following forms: 

1. Single slot to area 

Range to copy from: a single slot, eg Al. 

Range to copy to: an area, eg B3 D7, or just a row or column range. The 
area can include the original slot, if required. 

The contents of the slot are copied over the entire area, as represented 
symbolically in the following diagram: 



A B C D 




A B C D 
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2. Column to area 



Range to copy from: a column array, eg A1 A3. 

Range to copy to: a single slot or a row array, eg B5 D5. 



The column is copied to the target column starting at either the single 
slot, or the range of slots given by the target row. 




A B C D 




3. Row to area 

Range to copy from: a row array, eg A1C1. 

Range to copy to: a single slot or a column array, eg B5 B7. 

The row is copied to the target row, starting either at the single slot or 
at the range of slots given by the target column, as shown on the 
following page: 
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4. Area to area 

Range to copy from: an area, eg A1 B2. 
Range to copy to: a single slot, eg C5. 



The area is copied to the area with the top left-hand comer defined by 
the single slot. 




If the slots contain slot references, the references are updated to take 
account of their altered position, unless they are fixed with the $ 
operator. 
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Copy, Move, and Delete 



Sorting 



Copy - ❖BC 

Copies a marked block of slots to the position in the document indicated 
by the cursor. Slots in the document will be moved apart to make space 
for the block being copied, in contrast with the Replicate command 
which overwrites the target area. 

Slot references in the new block are updated as for the Replicate 
command, but references to slots within the block are not altered. 

Move - OBM 

Moves a marked block of slots from its original position to the position 
indicated by the cursor. All slot references are updated as appropriate. 

Note that if you attempt to move a block of slots to a new position which 
overlaps the same rows or columns as the original block, the error 

Overlap 

will be displayed. 

Delete - OBD 

Deletes a marked block of slots from the document. Since you will lose 
the information previously in those slots, it is a good idea to save a copy 
of your document before deleting a large area, so that you can revert to 
this if you accidentally delete valuable information. 



Sort - OBSO 

Sorts a marked block of slots. Text slots are sorted into alphabetical 
order, expression slots into numeric order, and date slots into date order. 
The following options are displayed: 

Sort on column 

Sort in reverse order No 

Don't update references No 

Sort on column: set to a column label (A, B, C etc) to specify which 
column within the marked block should be used to determine the 
ordering of the slots. 
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Searching and replacing 



Sort in reverse order: by default, the marked block is sorted into 
ascending order, and any slot references are updated as appropriate. 
Setting this option to V es will sort the specified column in descending 
order. 

Don't update references: setting this option to V es inhibits the updating 
of slot references within the block being sorted. This gives a faster sort 
operation, and can be used provided no slots within the sorted block are 
referred to either from within or from outside the sorted block. 



Search - OBSE 

Search is for a specified string within a single document, or a multi-file 
document. The following options are available: 



String to search for 
Search only range of columns No 

Equate upper and lower case Ves 

Search only marked block No 

Search from current file No 

Search all files in list No 



The string to be searched for is specified in the same way as for the 
Replace command, and the equivalent options have the same effect; see 
below. 

When the search is completed, a message such as 
27 found 

will be displayed where 2 7 is the number of matches since the last 
Search command. 

Next Match - OBNM 

Following a Search command, the Next match command can be used to 
find the next occurrence of the specified string starting at the current 
cursor position. 

Replace - O BRP 

Searches for and replaces occurrences of one specified string by another. 
The following options are displayed: 




no 
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String to search for 
Replace with 

Search only range of columns No 

Equate upper and lower case Ves 

Rsk for confirmation Ves 

Search only marked block No 

Search all files in list No 



By default, the Replace command replaces all occurrences of the first 
specified string with the second specified string throughout the current 
document, equating upper- and lower-case letters and prompting for 
confirmation before each replacement. For example 

String to search for Cat 

Replace with Dog 

will replace Cat with Dog, cat with dog, and CAT with DOG. 

On each occurrence of the search string, the prompt 

Replace: N, V? 

will be displayed at the top of the screen. Answer Y to perform the 
replacement, N to proceed to the next occurrence of the search string, or 
press the [esc] key to cancel the command. When the command is 
completed, the message 

27 found 

(or as appropriate) will be displayed to show the total number of 
replacements that have been made. 

String to search for: specifies the search string, which can be up to 240 
characters in length. 

Certain special sequences of characters can be used in the search string 
to represent characters which cannot be typed at the keyboard, or 
classes of search string: 
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Sequence 


Matches 


A1..A8 


Highlight character 


AA 


A 


A? 


A single character - not space 


A# 


Any number of non-space characters (ie a word) 


AS 


A space 


ARref 


Slot reference ref 


AR# 


Any slot reference 


space 


One or more spaces, or across slots 


AB 


Beginning of a slot (or line) 



Replace with: specifies the string to replace each occurrence of the 
search string. The following special sequences of characters can be 
used: 



Sequence 


Substitutes 


A1..A8 


Highlight character 


AA 


A 


A?n 


Character matching nth a? in search 


A#n 


String matching nth a# in search 


AS 


A space 


ARref 


Slot reference ref 


AR#n 


Slot reference matching nth ar# 


space 


Matching spaces or slot boundary 



Up to nine a? fields, nine a# fields and nine ar# fields, numbered 1 to 9, 
can be used in the same replace string. 



The wild field will match zero characters, as long as the string which 
has been searched for contains at least one character (otherwise the 
wild field would match all spaces). 

Search and Replace examples 

The sequences ai to A8 represent highlight codes 1 to 8. For example, 
all occurrences ofPipeDream could be put into bold with the options 

String to search for Pip eD re am 

Replace with ^2P ipeDream^2 



The sequence ab forces the search string to start at the beginning of a 
line. For example, all single spaces could be removed from the 
beginnings of lines with the options 








112 



Section Five - PipeDieam Reference 



String to search for 
Replace with 

The sequence a# will match a sequence of characters not containing a 
space; ie a word, or a number. For example, to strip line numbers from 
spooled BASIC programs: 

String to search for 

Replacewith / ' , S 

Where a# or a? have been used to search for any words or characters, 
the words or characters that were found can be inserted in the Replace 
with string using a#i to a#9, or a?i to a?9 respectively. For example, 

String to search for c A ?r A ? 

Replacewith A ?2~?1 ck 

will change cart to tack and cord to dock. 

The sequence ARref and ar# respectively match a specific slot 
reference, and any slot reference, in an expression slot. Thus, 

String to search for A R# 

Replace with ^R#1+1 

will replace all slot reference A1 by Al+1, and so on. 

Search only range of columns: enables you to specify a column range by 
entering a pair of column labels separated by a space: eg A G. The 
command is then restricted to the specified range of columns, inclusive. 

Equate upper and lower case: by default, upper- and lower-case letters 
are treated as equivalent in the search string and the cases of letters in 
the replace string are altered to match the cases of the letters in 
corresponding positions of the matched string. Setting this option to N o 
forces matches to be identical case. This means that, for example, 
specifying Do g to replace Cat- will have no effect on cat or CAT. 

Ask for confirmation: setting this option to N o causes all strings to be 
replaced without prompting. 

Search only marked block: setting this option to V es restricts the search 
to a marked block of slots. 
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Other block operations 



Search from current file : setting this option to V es performs the search 
and replace operation throughout a multi-file document, starting at the 
top of the current file. 

Search all files in list : setting this option to Ves performs the search and 
replace operation throughout a multi-file document, starting at the top of 
the first file. See Multi-file documents, p. 128. 



Word Count - OBWC 

Counts the words in the whole document, or in a block of slots if one has 
been marked, and displays the number of words, for example 

127 words 

at the top of the screen. Note that numbers and other symbols separated 
by spaces will contribute towards the word count. 

New - OBNEW 

Clears the entire document. The query 
Overwrite text? 

is given. If you clear the document (by answering Ves), this will cancel 
all file names and multi-file mode, resetting the Options Page options to 
their defaults, and resetting the screen display to its starting state of six 
columns, each 12 characters wide. 

Recalculate -OA 

Recalculates all expression slots throughout the entire document. The 
order of recalculation is determined by the columns/rows Options Page 
setting. 




Moving about the document - CURSOR 



PIREDRERM 


End of Slot 


o <>• 


Next Word 


SHIFT 


Next Column 


EiTT3 




oz 


BLOCKS 


Start of Slot 


0 <> 


Previous Word 


SHIFT 


Previous Column 


SHIFT fcjiU 


RDURNCE 




CURSOR 


Top of Column 


off 


Screen Up 


SHIFT ^ 


First Column 


«CFC 


« 0- V 




EDIT 


Bottom of Column 




Screen Down 


SHIFT 0 


Last Column 


*CLC 


SELECT 




FILES 


Save Position 


oCSP 


Cursor Right 








KmBi| 




LRYOUT 


Restore Position 


oCRP 


Cursor Left 


<> 






RCTION 




OPTIONS 


Go to Slot 


OCGS 


Cursor Up 


■0- 






■ ESCW 




PRINT 


ENTER 




Cursor Down 


■0 






RESUME | 





The commands on the CURSOR menu aim to provide the greatest 
possible flexibility for moving around a document. Because they are 
used so frequently, many of them have simple shorthand equivalents, 
which can save you a lot of time. 

You can move to the left or right a character, word, or column at a time, 
or to the start or end of a slot, or to the first or last column. 

You can move up or down the document a row at a time, a screenful at a 
time, or to the top or bottom of the column. 

You can also go directly to a specified slot by giving its coordinates. 

The commands on the CURSOR menu do not modify the document in 
any way, with the exception of the IenterI command which will add a 
blank row at the bottom of the document if the cursor was previously at 
the bottom of the document. 



Moving anywhere Go to Slot - OCGS 

Moves the cursor directly to a specified slot. After the prompt 
Go to slot 

type the coordinates of the slot you want to move to, followed by IenterI . 
If the slot you specify is off the document, the cursor will be moved as 
far as possible in the direction of the specified slot. 











Moving about the document - CURSOR 
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Moving within a line/slot 



Save Position - OCSP 

Saves the cursor position of the line containing the cursor in PipeDream. 
If you move to a new position, you can jump back to the previous 
position with the Restore Position command. Up to five positions can be 
saved. 

Restore Position -OCRP 

Moves the cursor to the last position saved. If five positions have already 
been saved, the Save Position command will give a bleep warning. 



Cursor Right - O 
Cursor Left - O 

Moves the cursor to the next character in the slot, or the previous 
character in the slot respectively. Cursor Left will have no effect once 
the cursor reaches the beginning of the slot. Cursor Right will continue 
to move the cursor beyond the end of the slot, scrolling the slot left if it 
reaches the wrap point for the column. 

Next Word - [a¥flQ 
Previous Word - ISHIFTI O 

Moves the cursor to the first character of the next word in the slot, and 
the previous word in the slot respectively. If there are no more words in 
the current slot, Next Word will move the cursor to the first character of 
the next slot. Likewise, if the cursor is at the be ginnin g of a slot, 
Previous Word will move the cursor to the end of the previous slot. 

Beginning of Line - OO 

Moves the cursor to the first character position in the slot. 

End of Line - OO 

Moves the cursor to the position after the last character in the slot. 
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Moving within a column 



Moving between columns 



ENTER - [ENTER! 

Moves the cursor down to the next row and to the first character 
position in the current column. If the cursor is at the bottom of the 
document, the command will add an extra row to the document. 

Cursor Up - 0 
Cursor Down - 0 

Moves the cursor to the same horizontal position in the previous line and 
the next line respectively: the cursor remains in the current column. 
Cursor Up will have no effect if the cursor is already on the top line of 
the document, and Cursor Down will have no effect if the cursor is 
already on the bottom line of the document. 

Screen Up - IshiftIQ 
Screen Down - [shift! O 

Moves the cursor up or down a screenful at a time. With borders 
displayed this will be five lines at a time. 

Top of Column - oO 
Bottom of Column - ❖0 

Moves the cursor to the top or bottom of the current column in the 
document respectively. 



First Column - OCFC or O f tab! 

Last Column - OCLC 

These commands move the cursor to the first or left-most column on the 
document, and last or right-most column on the document respectively. 
The cursor stays in the same row, but will be moved to the first (left- 
most) character position in the specified column. 

Next Column- (tab! 

Previous Column - [SHIFT! [tab! 

Moves the cursor to the next column on the right, or the previous 
column on the left, respectively. The cursor remains in the same row, 
but moves to the beginning of the slot in the new column. 




Moving about the document - CURSOR 
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Summary of PipeDream cursor operations 






Editing text and expressions - EDIT 
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The commands on the EDIT menu provide for various modifications on 
the contents of document. In the first place, there are commands which 
allow you to delete a character, word, slot, row or column on the 
document. 

You can also insert a row or a column, join two slots or split a slot, and 
insert a page break. 

Some of these commands are especially useful when working with 
multi-column documents: see Widths and margins in a multi-column 
document, p. 132 

The remaining commands are divided into two groups; the first applies 
specifically to working with text, the second to working with expression 
slots: 

Format Paragraph reformats a paragraph of text within a column, Swap 
Case swaps the case of a single character, and Insert/Overtype changes 
PipeDream between Insert and Overtype text entry modes. 

Edit Expression allows you to enter an expression, Number to Text 
converts between an expression slot and a text slot and Insert 
Reference inserts a slot reference into an expression. 













Editing text and expressions - EDIT 
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Editing within a line/slot 



Insert/Overtype - OV 

Switches the text entry mode between Insert and Overtype. The mode 
currently selected is displayed on the top line of the Options Page. 

In Insert mode, characters typed are inserted at the cursor position, and 
subsequent text on the line moves apart to make space. 

In Overtype mode, characters type over any text previously on the same 
line, in the same way as a correcting typewriter works. 

The mode you choose to work in is a matter of personal preference. The 
selected mode is specific to each PipeDream suspended activity; the 
default mode can be set in the Panel. 

Rubout - [del] 

The Rubout command, normally used by pressing the [HQ key, deletes 
to the left. The [del] key is used to remove a mistake in the line you have 
just typed. In Insert mode the remaining characters on the line move one 
position to the left. Note that [HD will not jump back to the previous line 
when the left-hand margin of a page is reached. 

Delete Character - <>G or ISHlFTllDEtl 

Deletes to the right. You would normally use the Delete Character 
command to delete one or more characters in the middle of a line of text. 

Insert Character - <>U 

Inserts a space at the cursor position, leaving the cursor where it is and 
moving subsequent text on the line to the right. The Insert Character 
command is used when working in Overtype mode, to create spaces in 
which to insert additional text within a line. 

Delete Word - OT 

Deletes all the characters from the current cursor position, up to but not 
including the first character of the next word. Normally you would 
position the cursor at the beginning of the word you want to delete, 
using the Next Word and Previous Word commands, and then give the 
Delete Word command to delete everything up to the next word. Note 
that Delete Word will not delete beyond the end of the current slot. 
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Editing within a column 



Delete to End of Slot - <>D 

Deletes all characters from the current cursor position to the end of the 
slot. 

Swap Case - OS 

Changes the case of the character under the cursor, and moves the 
cursor one position to the right. 



Delete Row in Column - ❖EDRC 

Deletes the slot containing the cursor and closes up the gap, so that 
subsequent rows in the current column move up on the document. This 
command will typically be used when PipeDream is operating in 
Columns mode, so that the text in the current column does not have to 
remain aligned with the text in adjacent columns. 

Insert Row in Column - OEIRC 

Inserts a row in the column containing the cursor. Subsequent rows in 
the current column are moved down to make space. The Insert Row in 
Column command is typically used when working in Columns mode, as 
it does not affect the text in columns to either side of the column 
containing the cursor. It is also useful for restoring the alignment of a 
table containing items in different columns. 

Join Lines - OEJL 

Joins the text in the line below the current line onto the end of the 
current line, and closes up the gap so that subsequent slots in the 
current column are moved up one row. 

Split Line - OESL 

Splits the current line at the cursor position. The character at the cursor 
position and subsequent characters are moved to the next row and the 
cursor remains at the end of the current slot. 

Format Paragraph - ❖R 

Reformats text from the line containing the cursor to the end of the 
paragraph. The lines of text will be split at the last space before the 




Editing text and expressions - EDIT 
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Editing a document 



right-hand margin for the current column; see Starting PipeDream, 
p. 32. If justification has been selected, with the Options Page Justify 
option (see p. 140), additional spaces will be added to each line to make 
the right-hand end always coincide with the wrap point. The end of the 
paragraph is determined by one of the following: 

A line beginning with at least one space 

An expression slot 

A slot with alignment other than free align; in other words, left align, 
right align or LCR align. 

You can prevent words from being split at a space by typing <> space, 
which is called an ‘exact space’ and is displayed on the screen as 
For example, 

£7. ..KHz 



Delete Row - OY or OlDELl 

Deletes the row containing the cursor across the entire document, 
closing up the gap. This command should he used with care, since the 
slot in every column on the current row will be deleted. The command is 
typically used when PipeDream is operating in Rows mode, in order to 
maintain alignment between text in adjacent col umns . 

Delete Column - OEDC 

Deletes the column containing the cursor. Note that all information in 
the column will be lost, so use this command with caution. 

Insert Page - OEIP 

Normally, page breaks are inserted automatically by PipeDream. These 
are called ’soft’ page breaks, and are represented by a horizontal line 



across the document between two rows. Their position will change if 
you alter the amount of text on a page, or change the margin settings on 
the Options Page. 
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However, to force a page break to occur at a specific place in the 
document, such as before a new chapter, you can insert a ‘hard’ page 
break with the Insert Page command. Hard page breaks are displayed 
as a row on the document 



Using this command will insert a hard page break in the row containing 
the cursor. The command gives the prompt 

Specify no. of unbroken lines No 

Pressing 1ENTERI executes the command, thereby ensuring that 
subsequent text will always start at the top of a new page. 

Alternatively, altering the option to Ves followed by a number enters a 
conditional hard page break. This means that a page break will occur if 
less than the specified number of lines is available on the current page. 
For example, before a table of ten lines one might insert a conditional 
hard page break with a value of 10 to ensure that all ten lines of the 
table were on the same page. 

If the conditional hard page break does not cause a page break, it will be 
displayed in column A as: 

Insert Row - ON 

Inserts a blank row across the entire document before the row 
containing the cursor. Subsequent rows are moved down to make space. 
The Insert Row command is typically used when working in Rows mode 
(see the Options Page), since it maintains alignment between text in 
adjacent columns. 

Insert Column - OEIC 

Inserts a blank column to the left of the column containing the cursor. 
The new column is created with an initial width of 12 characters, and an 
initial wrap- width of zero. The cursor remains in the new column. 




Editing text and expressions - EDIT 
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Add Column - OEAC 

Adds a blank column at the right-hand side of the document. The new 
column is added with an initial width of 12 characters, and a wrap-width 
of zero so that text in the new column will wrap at the right-hand edge 
of the column. 



Editing expression slots 



Insert Reference - bK 



Enables expressions to be built up by indicating, or 'pointing to', various 
slots to which an expression will refer. It inserts the coordinates of the 
slot containing the cursor into the expression being edited. To perform 
the command, move the block cursor to the required slot using the 
cursor keys, and type bK. 

If an expression is not being edited, this command will have no effect. 

Edit Expression - OX 



Sets the slot containing the cursor to an expression slot, or edits an 
existing expression slot. 



The slot is highlighted, and the cursor moves to the editing line above 
the top border at the centre of the screen. The current contents of the 
slot, if any, are displayed, and they can be edited using the cursor keys 
and line editing commands: 



iDELl 

ISHIFTl [DEL] 

bV 

bU 

bT 

bD 

bK 

<=i,o 

[si¥T1 0. [SHFf1 c> 

b<n,bC> 



Rubout 

Delete character 
Insert/Overtype 
Insert character 
Delete word 
Delete to end of slot 
Insert reference 
Cursor left/Cursor right 
Previous word/Next word 
Beginning of line/End of line 



Finally press UnTerI to enter the expression into the slot and display its 
value, or (esc) to leave the slot’s previous value unaltered. 
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Escape - Use] 

Exits from the Options Page, or from the options of any PipeDream 
command, [esc] will also abandon the editing of an expression and leave 
the contents of the slot being edited unchanged. 

Number < > Text - OENT 

Converts the slot containing the cursor between an expression slot and 
a text slot. This command allows a number inadvertently entered as text 
to be converted to an expression, or the equation in an expression slot to 
be displayed as text so that it can be printed out. 

The following procedure can be used to display, or print out, all the 
expressions within a particular area of a spreadsheet or document: 

® Save the document first, as the procedure will alter it. 

® Mark as much of the document as you wish to examine or print out. 

(D Type OENT. Expression slots within the marked block will display 
the expressions they contain. Note that text slots will display the 
error Typing error. 

® Press OQ to clear the marked block, and, if necessary, increase the 
column widths so that the full expressions can be seen. 



Working with files - FILES 
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The commands on the FILES menu allow you to load documents from 
the Z88 filing system, and save documents to the filing system. 

You can create a document consisting of several files linked together by 
a List file. Commands are available to move to the next file or previous 
file, or go directly to the first file or last file in a multi-file document. 

For simple use of PipeDream you do not need to use files, since you can 
leave documents you are working on as suspended applications. 
However, since there is a small overhead in keeping suspended 
applications, saving a large number of small documents as files will 
prevent the inconveniences of memory low conditions. 



File names When you start PipeDream with a blank document, the document will 

have no File name associated with it, and it will show: 

File No File 

at the top right-hand side of the Options Page. A File name can be given 
to a document with the Name command. Loading a file, with the Load 
command, will set the File name to the name of the loaded file. 

The File name of the document is displayed in the Options Page, and is 
used as the default file name in the options for the Save and Name 
commands. The File name is also used to label PipeDream suspended 
activities, in the Index YOUR REF. column. 
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Loading a document 



Name - OFC 

Sets the File name for the current document. Gives the prompt: 

New nane of file 

The current File name, if an y, wil l be displayed; this should be edited to 
the new name, followed by IenterI . 



Load - OFL 

Loads a document of a given name from the filing system. The following 
options are displayed: 

Nane of file to load 
Insert at slot No 

Linit to range of rows No 

Load as plain text No 

Name of file to load: specifies the file name. If a file of the same name 
but with the extension 1 . L’ exists, this file is taken as a List file; see 
Multi-file documents, p. 128. If not, the specified file is loaded. 

The File name, displayed in the Options Page, will be set to the name of 
the file loaded. In the case of a multi-file document, this will be the name 
of the current document, not the name of the List file. 

Instead of typing the file name, the file can be selected from the Filer. 
After typing OFL, call the Filer by typing DF and select the required 
document using the cursor keys followed by IenterI (see Selecting files, 
p. 83). You can then return to PipeDream from the Filer by pressing [esc] , 
and the full file name will have been entered for you. Press IenterI to load 
the file. 

If the document in memory has been altered since last saving it, the 
message 

Overwrite text? 

will be displayed, and the document will only be loaded if Y (or y) is 
typed. If the document is too large to fit into memory, only the first 
section will be loaded, and the display will show the message 




Working with files - FILES 
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Saving a document 



Memory full 

Insert at slot: appends the file to the document already in memory, 
either at the specified slot reference, or at the current cursor position if 
no slot reference is specified. Type Y for the option 

Insert at slot Ves 

and enter a slot reference. 

Limit to range of rows: enables files too large for the available memory 
to be edited by splitting them up into sections. If the option is set to 
V es, a range of rows can be entered as two numbers separated by a 
space. Only rows lying between the specified range, inclusive, will be 
loaded. 

Load as plain text: if V es is specified, the file is interpreted as plain 
text. Sections of text on each line separated by tabs are put into 
successive columns across each row of the PipeDream document. 

After loading a document, expression slots are recalculated twice, once 
to obtain the correct values of constant slots, and then again to ensure 
that references to constant slots have the correct values. If the document 
contains complicated forward referencing, it may need further 
recalculation before the values of slots stabilise. 



Save - ❖ FS 

If none of the options are changed, pressing IenterI saves the whole of 
the current document to the name last set by the Load or Name 
commands. 

The following options are displayed: 



Name 


of file to save 




Save 


only range of columns 


No 


Save 


selection of rows 


No 


Save 


marked block 


No 


Save 


plain text 


No 



Name of file to save: by default, the current File name is displayed, as 
shown in the Options Page. This can be edited to save the document 
under a different name. 
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Multi-file documents 



Save only range of columns: altering this option to Ves allows you to 
specify a range of columns. This should be given as two column labels, 
separated by a space: for example, A F. Only the text within the range 
of columns, inclusive, will be saved. 

Save selection of rows: altering this option to V es allows you to enter an 
expression. Only rows for which the expression evaluates to TRUE will 
be saved. 

For example, column E in an inventory of goods may represent the 
quantity of each item in stock. To save a copy of the database which 
excluded out-of -stock items, you would type 

Save selection of rows Ves El >0 

All row references in the expression are incremented before the 
expression is evaluated for each row in the document. So in this 
example row 6 will be saved if E6>0. 

Save marked block : altering this option to Ves specifies that only the 
marked block of text should be saved. 

Save plain text: altering this option to V es will save the document as a 
plain text file, containing no special constructs. The contents of each 
successive column will be output separated by tab characters, with each 
row terminated by a return character. 



Documents comprised of several different files can be edited and printed 
as a single document by means of a PipeDream List file. 

The List file is a plain text file containing the names of all the files 
making up the entire document. It should be saved with the Save plain 
text option, with each file name on a separate line. 

The List file should be given a name with the extension ‘ . L’. A file with 
extension 1 . L’ is taken as a List file when loading, and the first 
document in the list will be loaded. 

Any error which occurs during the processing of a multi-file document 
cancels the multi-file mode after reporting the error, to avoid overwriting 
files with incorrect text. 



Working with files - FILES 
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The following commands provide a convenient way of moving between 
files in a multi-file document: 

Next File - OFN 

Loads the next file in a multi-file document, but first saves the current 
file if it has been altered since the last save command. 

Previous File - OFP 

Loads the previous file in a multi-file document. The current document is 
saved if it has been altered since last saving it. 

Top File - OFT 

Loads the first file in a multi-file document. The current document is first 
saved if it has been altered since last saving it. 

Bottom File - OFB 

Loads the last document in a multi-file document. The current document 
is first saved if it has been altered since last saving it. 

Multi-file example 

For example, first create a List file in PipeDream, containing the 
following text: 



R3 

H 




c 


D 




iF 


1 chapterone 

2 chaptertwo 

3 chapterthreefl 













Take care not to add any blank lines after the last file name. Then save 
this as a plain text file called book . L, by typing OFS book . L, and 
setting the Save plain text option to V . 
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Create three files, chapterone, chaptertwo, and chapter three, 
containing, for example, the following lines of text respectively: 



This 


i s 


the 


first chapter 


Thi s 


i s 


the 


second chapter 


Thi s 


i s 


chapter three 



Now load the multi-file document by typing OFL book. If you use the 
Filer to select the file you will need to delete the ‘ . L’ extension from the 
end of the file name. 

Typing OFN, OFP, OFT, and OFB will then move between the three 
files. 



Altering the document layout - LAYOUT 
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The commands in the LAYOUT menu allow you to specify how the 
information entered in a document is displayed. 

You can alter the width that any column occupies, and the column's 
right-hand margin, which determines the point at which lines of text 
entered into that column wrap onto the next line. 

You can also fix rows above the cursor position and columns to the left 
of the cursor position so that you can see information on one part of the 
document while editing information on another part. 



Column widths and margins Width - ow 

Specifies the width that a column occupies on the document. The 
following options are displayed: 

New width 

Specify column No 

If no column is specified, the column currently containing the cursor is 
assumed. 
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Widths and margins in a 
multi-column document 



Set Margin - OH 

Alters the right-hand margin of a specified column. The margin is 
indicated by the right-hand margin pointer, T ,on the top border, and 
determines the point at which text typed into the column will wrap onto 
the next line. 

This command determines the area over which text is to be formatted 
within the column; thus, if the width is set to zero, it will be equal to the 
column width, and there will be no margin. The following options are 
displayed: 

New width 

Specify column No 

If no column is specified, the column containing the cursor will be 
assumed. 

Margin Left - DO 
Margin Right - DC> 

These commands allow you to move the right-hand margin for a number 
of columns simultaneously. 

The commands move the right-hand margin pointer, , for the column 
containing the cursor one character position to the left or right 
respectively. They also set the wrap point of all columns between the 
current column and the wrap point so that they wrap at the same 
position. 



By default, the wrap point for all columns is set to the right-hand edge of 
the screen, which is most appropriate for creating tables of information 
within a single column of text. The Insert on wrap option on the Options 
Page is initially set to Rows, ensuring that information in adjacent 
columns will remain aligned. 

It is also possible to create a document with two or more independent 
columns of text, like the layout of a newspaper. 

You do this by moving the right-hand margin for each column to the 
right-hand edge of the column. Setting the Insert on wrap Options Page 
option to Columns will then ensure that the text in each column can be 
edited without affecting adjacent columns. 
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For example, the following steps can be used to create the three-column 
document shown below. 

© Set the widths of columns A, B, and C to 24, by giving the Width 
command on the LAYOUT menu with the options 



New width 24 

Specify column Vesfi 

New width 24 

Specify column Ves B 

New width 24 

Specify column Ves C 



© With the cursor in column A, move the right-hand margin to the 
right-hand edge of column A by pressing □ O until the right-hand 
margin pointer is just to the left of the A on the top border; see the 
diagram below. This will also position the left margin for columns B 
and C to the right-hand edge of those columns. 

® Enter the Options Page, by typing 00, and alter the Insert on wrap 
option to Columns by pressing 0 until the cursor is on the option 
line, and typing C to alter it to 

Insert on wrap C 

Press [esc] to exit from the Options Page. 

© Type the required text into each column; it will format automatically 
within the column width. 



R3 1 

4R B C. 

1 1. Send your name and 2. Within 10 days you 3. If not completely 

2 address with a postal will receive your own satisfied, return the 

3 order for £20.1 personal piranha fish, fish for a full refund. 

■=CT1, 



text 
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Alignment Text can be aligned in one of the following ways: 

© Left-aligned with the left-hand edge of the column. 

© Right-aligned with the right-hand margin pointer. 

® Centred between the left-hand edge of the column and the right- 
hand margin pointer. 

© Components of the line can be left-aligned, centred, and right- 
aligned (LCR alignment). 

Text in a slot which has been aligned with one of the Align commands 
will not be reformatted by the Format Paragraph command. 

The results of expression slots can similarly be displayed left-aligned, 
centred, or right-aligned over the width of the column. 

Right Align - O LAR 
Left Align - O LAL 

Aligns the text in the current slot to the right or left of the wrap-width of 
the current column, respectively. The alignment will be displayed when 
the cursor is moved off the slot. The Left Align command can, for 
example, be used to prevent text in a table from being inadvertently re- 
formatted with the Format Paragraph command. 

Centre Align - <> LAC 

Centres the text in the slot containing the cursor, or a marked block of 
slots, over the wrap-width of the column containing it. 

LCR Align - O LLCR 

Aligns components of the slot containing the cursor, or the slots within a 
marked block, to the left, centre, and right of the column’s text wrap- 
width. The line has the format 

/left/ centre/ right/ 

where left, centre, and right represent text which will be respectively 
left-aligned, centred and right-aligned, and 7’ represents an arbitrary 
delimiter, which must not occur elsewhere in the line of text. 



Altering the document layout - LAYOUT 
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Free Align - O LAF 

Removes the alignment from a slot containing the cursor, or a marked 
block of slots. Text, or the results of expression slots, will be left-aligned 
in the slot. 



Fixing rows and columns Fix Row - o lfr 

Fixes the row containing the cursor, and all rows above it, on the screen. 
If borders are displayed, the fixed rows are identified with horizontal 
lines in the left-hand border. Moving the cursor up or down on the 
document will scroll only those rows which have not been fixed, so the 
cursor can be moved to another part of the document while retaining the 
fixed rows on the screen. Giving the Fix Row command again frees the 
rows and restores the document to its original state. 

Fix Column - OLFC 

Fixes the column containing the cursor, and all columns to its left, on the 
screen. If borders are displayed, the fixed columns are identified in the 
top border by solid lines. If the cursor is moved on the document, only 
the columns that have not been fixed will scroll, so that the cursor can 
be moved to another part of the document while retaining the fixed 
columns on the screen. Giving the Fix Column command again frees the 
columns. 



For example, the top row of headings and leftmost column of labels have 
been fixed in the following document by giving the commands OLFR 
and OLFC with the cursor in slot A1 : 



fil 


H . . 


B. , 


c. . . 


D. . . 


E, , , , 


4,F 


mi } r 


2 

3 

4 

5 

6 


Rint chips 
Choc browns 
Sponges 
Flapjacks 
Queen cakes 


January 

10 

35 

124 


February 

9 

37 

6 

145 


March 

33 
1 1 

34 
3 

167 


April 

45 

23 

36 

4 

189 


May 

49 

7 

19 

6 

234 



The cursor can then be moved around to scroll the document while 
keeping the column headings and row labels in view. 
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Number formats 



Expressions can be displayed with a specified number of decimal places, 
or in free format. Negative numbers can be displayed either with a 
minus sign, or with brackets as in financial notation. The results of 
expression slots can also be displayed with one or more leading 
characters, such as '£' and one or more trailing characters, such as '%’. 
The leading and trailing characters for the document are specified in the 
Options Page. 

The format in which any expression slot is displayed can be restored to 
the default specified in the Options Page by the Default Format 
command. 

All the format commands can be applied either to the single slot 
containing the cursor, or to a block of slots by marking them before 
giving the command. 

Decimal Places - <>LDP 

Sets the number of decimal places displayed by an expression slot, or a 
marked block of expression slots. Gives the prompt 

Number of decimal places 

Floating format No 

The number of decimal places may be set to a value from 0 to 9, or 
floating format may be specified which uses the display format giving 
the most significant figures displayed in the available width. 

Sign Brackets - OLSB 
Sign Minus - <>LSM 

Specify that negative values in an expression slot or marked block of 
expression slots should be displayed in financial notation, enclosed in 
brackets, or with a minus sign prefix respectively. 

Leading Characters - <>LCL 
Trailing Characters - <>LCT 

Specify that the leading or trailing characters defined in the Options 
Page should be displayed for the expression slot contained in the cursor 
or the marked block of expression slots. The default leading and trailing 
characters are '£' and '%' respectively, and these can be altered on the 
Options Page. 



Altering the document layout - LAYOUT 
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Default Format - OLDF 

Restores the expression slot containing the cursor, or a marked block of 
expression slots, to the default format as specified on the Options Page. 
Once any element of an expression slot’s format has been altered with 
one of the commands Decimal Places, Sign Brackets, Sign Minus, 
Leading Characters or Trailing Characters, the slot’s format is frozen 
and will not be affected by subsequent alterations to the Options Page. 
Giving the Default Format command removes any specific format set on 
the slot. 



Document options - OPTIONS 





PIREDRERM 

BLOCKS 

CURSOR 

EDIT 

FILES 

LRYOUT 

OPTIONS 

PRINT 


Options Page 


O0 


msmmFTm 



The OPTIONS menu contains only one command, Options Page, or <>0, 
which displays a page of information about the current document 
together with the global settings which may be altered to effect the way 
that commands operate on the document. 



T ext/N umbers 


T 


Insert on wrap R 


Margins: Top 0 


File 


No File 


Borders 


V 


Calci Auto/Mah A 


Header 2 


Page 


1 Insert 


Justify 


N 


Columns/Rows C 


Footer 2 


Free 


20480 


Wrap 


V 


Decimal places 2 


Bottom 8 






Page length 


66 


Minus/'Brack.ets M 


Left 0 


Title 




Line spacing 


1 


Lead chs. £ 


Header 






Start page 




Trail chs. 


Footer 







You can return to a PipeDream document by pressing the He] key. 



Information lines The right-hand column of the Options Page display gives information 

about the current document. 

File 

The name of the document previously loaded with the Load command, 
or the name assigned to a document by the Name command (OFC) on 
the FILES menu. If no name has been specified, it will show 

No File 

The name will also appear on the SUSPENDED ACTIVITIES list in the 
Index display. 












Document options 



Option lines 



OPTIONS 
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Page 

Shows the current page number of the line containing the cursor. This 
will correspond to the page numbering when the document is printed 
unless rows are fixed with the Fix Row co mm and on the LAYOUT 
menu, or the Options Page page-length setting has been set to zero. 

Insert/Overtype 

Shows the current text entry mode selected by the Insert/Oveitype 
command on the EDIT menu. The mode initiall y selected is Insert mode. 

Microspace 

Normally blank, displays the word Microspace if the microspace 
option has been selected from the PRINT menu. 

Free 

Displays the amount of space remaining for characters in the current 
document, to the nearest multiple of 256 characters. It is inadvisable to 
continue typing text into a document if there are less than 
approximately 300 free characters. In such a situation you are advised to 
make space in memory by freeing activities, or deleting files. 



This page is used to determine how text and expressions are displayed 
in a document (including the default setting for the display of expression 
results) and to set up the layout of a document ready for printing, 
specifying headers and footers, and margins at the top, bottom and left 
of the page. In addition, you can control the length of the page, the 
spacing of text, and the page numbering. 

Altering options - Next Option 

As with many other commands, Next Option, OJ will alternate between 
two available values, for example Y and N for Ye- s and No , or T and N 
for To x t- and Nunters. Alternatively, these values can be changed 
by typing the appropriate letter. In the case of options with more than 
two possible values, O J will set the option back to its default value. 



Other options can be altered by moving the cursor to the appropriate 
item, with the 0 and -0 keys, and then editing the item with the line- 
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editing commands <□, i=>, (del] key and O G or (shIftIIdelI to delete the 
character under the cursor. In numeric fields, such as Page length, 
Overtype mode is automatically set irrespective of the current 
Overtype/Insert mode setting. 

In the following list of options the default value is shown against each 
option. 



Text format Determines the formatting of text in the document. 

Text/Numbers (T) 

Set to T (Text) to make the default slot format text slots, or N (Numbers) 
for expression slots. In Numbers mode there is no need to type OX 
before entering an expression, and the cursor keys O and O will move 
directly between slots containing expressions; ie behave like EMI and 
[shift] (Tab] , 

Borders (Y) 

Set to V (Yes) to display borders, or N (No) to hide borders. Hiding the 
borders allows a larger area of the sheet to be displayed, and can be 
useful for word-processing applications. 

Justify (N) 

Set to N (No justify) for ragged right margins, or Y (Yes) for even right- 
hand margins. To reformat a paragraph of text after changing this 
option, give the Format Paragraph command, OR. 

Wrap (Y) 

Set to Y (Yes) to make text wrap automatically at the wrap point, or N 
(No) for no wrapping. 

Insert on wrap (R) 

Set to R (Rows) to maintain alignment between adjacent rows, or C 
(Columns) for creating independent columns of text; see Widths and 
margins in a multi-column document, p. 132. 
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Recalculation mode 



Number formats 



The Calc options determine how expression slots are recalculated in 
the document. 

Auto/Man (A) 

Determines the recalculation of expression slots on the document. 

Set to R (Automatic) to recalculate the document every time an 
expression slot changes or M (Manual) for recalculation only with the OA 
command. This option can be set to M to make entering data into a large 
spreadsheet, or working with large text documents, faster. 

Columns/Rows (C) 

Select the order of recalculation: R (Rows) across rows first, or C 
(Columns) down columns first. 



Determine the default display format for numerical expression slots. 

Decimal places (2) 

Select 0 to 9 decimal places or F forfree format. 

Minus/brackets (M) 

Select M (Minus) to display negative numbers with a minus sign, or B 
(Brackets) for financial bracketed notation. 

Lead chs. (£) 

Trail chs. (%) 



Specify up to 4 characters to be displayed in front of or after expression 
slots with <>LCL or <>LCT set. 
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Page format Determines the spacing and pagination of the document when printed. 

Page length (66) 

Set to between 1 and 127 to specify the number of lines on each page, 
including margins, footer and header, or 0 to suppress page breaks 
altogether. 

Line spacing (1) 

You can specify from 0 to 255 additional blank lines to be inserted 
between each line of text. 

Start page 

You can set the current page number to 0 to 255. 



Headers, footers, and margins You can specify an additional header or footer line of text to appear at 

the top or bottom of each printed page respectively. Each line of text can 
consist of up to three components, which will be left-aligned, centred, 
and right-aligned. 

The left margin, and the margins above and below the header and 
footer, and between the header and footer and the page of text, can be 
separately altered to determine the layout of the printed page. 

Note that if a header or footer are specified, the number of lines of text 
on each page will be reduced accordingly. 



Document options 
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Top Margin 




Header Text 




Header Margin 


Left 


Page of text 


margin 






Footer Margin 




Footer Text 




Bottom Margin 



The complete page layout, with headers and footers and their associated 
margins, will be represented on the page map display at the right-hand 
side of the PipeDream screen. 

Header 

Footer 

You can specify lines of text which will be printed out at the head and 
foot of each page. Each line has the format 

/left/ centre/ right/ 

where left, centre, and right represent text which will be respectively 
left-aligned, centred and right-aligned, and V represents an arbitrary 
delimiter, which must not occur elsewhere in the line of text. 
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Title 

A line of up to 244 characters can be entered in this field as a title for the 
document. The title can be included in the document, or in the footer or 
header, by giving the @T@ field; see p. 158. 



Margins 



You can specify the number of blank lines, from 0 to 255, to be left above 
the header, between header and text, between text and footer, and 
below the footer respectively. The left margin can specify a margin of 0 
to 255 characters at the left of each page: 



Margins: Top 0 
Header 2 
Footer 2 
Bo t ton 8 
Left 0 



For example, a typical set-up might be 



Margins: Top 
Header 
Footer 
Bo t ton 
Left 
Header 
Footer 



2 

2 

2 

2 

6 

/@T@//Maxo Ltd/ 
//Page 0P0// 



Title Quarterly Report 



The @-field 0P@ will be replaced by the current page number, and the 
@-field 0T@ by the Title. The resulting page layout would be as follows: 




Printing documents - PRINT 



PIREDRERM 


Print 


©PO 


Jnderl i n* 


©PU 


Insert Highlights 


©PHI 




oz 


BLOCKS 


Microspace Pitch 


©PM 


Bold 


©P8 


Remove Highlights 


©PHR 


RDURNCE 




CURSOR 




Ext. Sequence 
Itai ic 
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EDIT 
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FILES 
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©PL 
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LRYOUT 






Superscr ipt 


©PR 
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OPTIONS 
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■ ESCM 




PRIMT 






User Defined 
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RESUME | 





The commands on the PRINT menu allow you to print your document 
and to take advantage of facilities offered by the printer, such as bold 
and under lined text, and alternative fonts. 

Print -OPO 

Prints all or part of a document. The following options are displayed: 

Print only range of columns No 

Select rows to print No 

Wait between pages No 

By default, the Print command prints the whole of the current document 
with no pause between pages. 

The starting page number is determined by the Options Page Start page 
setting, except when printing a marked block, or selected rows. In this 
case the pages will be numbered, starting at 1, and soft page breaks will 
be ignored. 

Print only range of columns: setting this option to V es will allow a 
column range to be specified. The column range should be given as two 
column labels, separated by a space. Only the columns within the 
specified range (inclusive) will be printed. 

Select rows to print : setting this option to V es will allow an expression 
to be entered. Rows will only be printed if the expression evaluates to a 
true or non-zero result. The expression can contain slot references; after 
each row the slot references are updated by one row, unless they are 
fixed with the $ operator. 
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For example, a document containing text in column B could use column 
A to contain a character, indicating the latest revisions to the 
document. To print out only the revised lines the option 

Select rows to print Yes 

could be specified. See also Printing selected rows, p. 54, for an 
example. 

Wait between pages: setting this option to Y es gives a prompt between 
pages to allow single sheets to be inserted into the printer. The prompt 

Page n . . 

is displayed, where n is the page number. You can then press one of the 
following keys to control printing: 

M to miss the page 

C to continue printing all remaining pages without further prompting 
Any other character (eg the space bar) to print the page 
[esc! to abandon printing. 

Printing a marked block: if a block of slots is marked when the Print 
command is given, only the marked slots will be printed. 

Multi-file documents: if the Print command is given in a multi-file 
document, the current document will be saved if it is modified, and the 
entire multi-file document will be printed, starting with the first file. 

Microspace pitch - OPM 

Selects microspaced printed output. Gives the prompt 

Microspace printed output No 

Changing the option to Yes and pressing IenterI causes subsequent 
output to be microspaced at the default spacing of 12/120ths of an inch, 
giving a pitch of 10 characters per inch. A number can be entered to 
specify an alternative spacing. For example, entering 10 gives 12 
characters per inch. Microspace- is displayed at the top right-hand 
comer of the Options Page display if it has been selected. 
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Highlighting text 



You can alter the style of text in your document by inserting one of eight 
highlight codes in front of the text, and the same code after the text to 
revert back to normal. 

Highlight codes 

The recommended assignment of the eight codes is as follows: 



Code 


Function 


Printed example 


1 


Underline 


underlined type 


2 


Bold 


bold type 


3 


Extended sequence 


e g n 


4 


Italic 


italic type 


5 


Subscript 


H,0 


6 


Superscript 


e=mc 2 


7 


Alternative font 


alternative font 


8 


User defined 





To obtain the right results when these codes are printed you may need 
to create a printer driver; see Section Nine - The Printer Editor. 



The codes are inserted into text with the following commands: 

Underline (1) - OPU 
Bold (2) -OPB 

Extended Sequence (3) - OPX 
Italic (4) -OPI 
Subscript (5) - OPL 
Superscript (6) - OPR 
Alternative font (7) - OPA 
User Defined (8) - OPE 

These commands insert the corresponding highlight code at the current 
cursor position. Successive occurrences of a highlight code enable and 
disable the corresponding printer facility. 

The effect of highlights 1, 2, 3, and 4 (underline, bold, extended 
sequences, and italic text styles) are displayed on the screen as 
underlined, bold, grey, and tiny characters respectively when the cursor 
is moved onto another slot. When the cursor is on the same slot, all 
highlight codes are displayed as the corresponding highlighted numbers 
UtoB. 
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Highlight characters are considered to be of zero width for formatting 
and justification. 

Note: You can use OSPACE to create an ‘exact space’ character. This 
may help to create continuous underlining of titles etc. 

Insert Highlights - OPHI 

Inserts a specified highlight number in the text at the cursor position. 
Gives the prompt 

Highlight number 

Typing in a number between 1 and 8 , followed by IenterI , will insert the 
corresponding highlight code into the text. 

Remove Highlights - OPHR 

Removes all occurrences of a specified highlight number from a given 
marked block of text. Gives the prompt 

Highlight number 

Typing a number between 1 and 8 followed by IenterI will remove all 
occurrences of the corresponding highlight from the marked block. 

Highlight Block -❖PHB 

Highlights all words within a marked block of text with a given highlight 
number. Gives the prompt 

Highlight number 

Typing a number between 1 and 8 will remove any existing highlights of 
the same number and highlight all words in the marked block with pairs 
of the specified highlight character. Because individual words are 
highlighted, reformatting the highlighted block of text will leave the 
selected text correctly highlighted, and text will be printed correctly 
even if the highlighted block extends over a page break. 



Expression slots 



Any slot in a PipeDream document can be designated as an expression 
slot, in which case the expression you type into it will be evaluated, and 
the result will be displayed in the corresponding position in the 
document. 

An expression is entered by giving the Edit Expression co mm and on the 
EDIT menu, or by typing OX. The cursor will then move to the editing 
line, at the top of the screen, until the expression is entered by typing 

lENTERl . 

Alternatively, if the Options Page Text/Numbers option is set to N , all 
entries are taken as expressions. 



Expressions Expressions can consist of numbers, functions performing operations on 

other expressions, references to other slots, or a combination of these 
combined by mathematical operators. Expressions can give a numerical 
result, a date, or a string of text. Illegal expressions will give an error as 
their result. 

Numbers 

Numbers can be expressed in normal notation, or scientific notation. For 
example, 

1, -1.7632, 1.4e27. 0.001 

All calculations are performed to an accuracy of nine decimal places and 
numbers may he between le38 and le-38. 

Strings 

Strings are entered between double quotes, and may contain spaces. A 
slot reference to a text slot returns a string. 

Slot references 



The form of a slot reference is 
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column-label row-number 
separated by optional spaces, where 

column-label designates one of the 64 columns, A to Z, followed by AA 
to BN, and 

row-number is from 1 to 32768. 

Slot references are normally ‘relative’; the reference will be updated if 
the position of the slot containing the reference changes relative to other 
slots. 

Each half of the slot reference may be ‘fixed’ by preceding the column 
letter or the row number by a dollar sign. The possibilities are: 

A1 normal reference 

$ A 1 fixed column reference 

A $ 1 fixed row reference 

$ A $ 1 fixed column, fixed row 

The fixed part of a reference is not altered when copied with the 
Replicate or Copy commands on the BLOCKS menu, or when placed in a 
selection expression for the Save and Print commands on the FILES and 
PRINT menus respectively. 

When a slot to which a slot reference refers is deleted, the slot reference 
is marked with a '%' sign to indicate that the reference is no longer 
valid. The expression containing the slot reference will display the Bad 
slot error message. 

Specifying a block of slots - Ranges 

You can perform some functions on a block of slots, specified by the top 
left-hand comer of the block followed by the bottom right-hand comer of 
the block. 

For example 

A2 D8 

specifies all the slots in the block between columns A and D, and rows 2 
and 8 inclusive. 
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In some cases the function only makes sense if the range is restricted to 
a single row (a ‘row range’) as in A1 Dl, or a single column (a ‘column 
range’), as in B8 B20. 

Specifying several slots - Lists 

Functions are available to count, choose from, or find the maximum or 
minimum of a list of elements. The elements in a list are separated by 
commas and can be simple slot references, or ranges. Each slot in a 
range is considered as a separate list element. For example, 

13, B1 B5 , C7 , 

is a list containing the 7 elements 1 3 , Bl, B2, B3, B4, B5,andC7. 

Dates 

Dates are entered in the format 
DD.MM.YYYY or MM.DD.YYYY 

depending on whether the Panel date-format setting is European or 
American. 

Dates can be sorted into chronological order, and the functions DAY, 
MONTH, and YEAR can be used to extract the values of the date's day, 
month, and year respectively. 



Operators The following operators can be used within expressions 

Arithmetic 

The arithmetic operators take two numbers as operands. 

+ add - subtract 

* multiply / divide 

a raise to the power 

Also, ‘+’ and may be used on date values. For example 



12.10.1987 + 127 
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Functions 



will return the date 127 days after 12 October 87, or 16.2.88, assuming 
that European date format has been selected. 

Relational 



The relational operators can compare dates, strings, and numbers. Both 
operands must be of the same type, and the result is a logical value of 
FALSE=0 and TRUE = 1. 



< 


less than 




equal to 


<= 


less than or equal to 


> 


greater than 


<> 


not equal to 


>= 


greater than or equal to 



When strings are being compared, the following wildcards (as in the 
Replace command) can be included in the second string: 

a? matches any single character 

a# matches any number of characters 

aa represents a 

Logical 

The logical operators operate on numeric or logical values. Boolean 
FALSE is taken as zero, TRUE as non-zero. 

& AND I OR 

! unary NOT 



ABS Absolute value 

ABS(number) 

Returns the absolute positive value of the argument. 
ACS Arc cosine 

ACS(number) 

Returns the arc cosine of the argument, in radians. 
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ASN 



ATN 



CHOOSE 



COL 



COS 



COUNT 



Arc sine 

AS N( number) 

Returns the arc sine of the argument, in radians. 

Arc tangent 

ATN(number) 

Returns the arc tangent of the argument, in radians. 

Choose element from list 

CHOOSE(hst) 

Returns an element from the list, using the value of the first element as 
an index into the remaining elements. For example, if B4 contains 
17.2.1987 

CHOOSE (M0NTH( B4 ) , " jan" , "feb" , "mar" , "apr" ) 

gives the result feb. 

Column 

COL 

The value of the column in which it is evaluated. Column A is 1, column 
B is 2, etc. 

Cosine 

COS(radians) 

Returns the cosine of the argument. 

Count the number of elements 

COUNT(hst) 



Returns the number of non-blank slots in the list. 
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DAY Day of date 

DAY(date) 

Returns the day number of a date argument. 

For example, if slot A1 contains 17.3.1961, then DAY ( A1 ) returns 17 

DEG Degrees from radians 

DEG(radians) 

Converts the argument, taken in radians, into degrees. 

EXP Exponent 

EXP(number) 

Returns the constant e (2.71828184..) raised to the specified power. 

IF Conditional expression 
IF(boolean, then, else) 

If the value of the first argument is TRUE, ie non-zero, the function 
returns then; otherwise the function returns else. 

For example, if slot A1 contains -23, 

IF(A1<0. ’’Debit”. "Credit”) 

would return Debit. 

INDEX Index slot 

INDEX(column,row) 

Returns the evaluated expression or string found at coordinates column, 
row. For example, if A2 contained I F < 1 00," Debit" /'Credit") 

I NDEX ( 1 , 2 ) 



would return Credit. 
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MAX 



MIN 



MONTH 



PI 



RAD 



ROW 



SGN 



Maximum value in list 

MAX(list) 

Returns the maximum value from the slots in the list. 

Minimum value in list 

MIN(hst) 

Returns the minimum value from the slots in the list. 

Month of date 

MONTH(date) 

Returns the month number of its date argument. 

For example, if A1 contains 12,6,1 987 then MONTH ( A1 ) returns 6. 

7t 

PI 

Returns the value 3.141592653. 

Radians from degrees 

RAD( degrees) 

Returns the argument, taken as degrees, converted into radians. 

Row 

ROW 

The value of the row in which it is evaluated. 

Sign 

SGN( number) 

Returns -1, 0, or 1 depending on whether the argument is negative, zero, 
or positive respectively. 
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@ Fields 



SIN Sine 

SIN(radians) 

Returns the sine of the argument, in radians. 

SQR Square root 

SQR(number) 

Returns the positive square-root of its argument. 

SUM Sum 

SUM(list) 

Returns the sum of the slots in the list. 

TAN Tangent 

TAN(radians) 

Returns the tangent of the argument, in radians. 

YEAR Year of date 

Returns the year number of its date argument. 

For example, if A1 contains 12.6.1 987 then YEAR( A1 ) returns 87. 



You can include the page number, the date, the file title from the 
Options Page, or the value of any expression slot within text in your 
document using the special PipeDream @ -fields. 



The following @ fields are available: 



Identifier 


Effect 


@P@ 


current page number 


@D@ 


date 


@T@ 


title defined in options page 


@ref@ 


value of slot ref 


@@ 


@ 
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One or more ‘@’ characters should be given after the identifier to 
determine the size of the @ field for formatting. For example, 

@P@00@ 

creates a field of four characters. Provided the value to be displayed is 
less than the size of the @ -field, the line will be justified correctly. 

The field: 

@ref@@@@@ 

will reserve five characters for the value of the slot indicated by the 
reference. 

If it is an expression slot, the value will be displayed in the same format 
as in the slot itself, with alignment ignored. 

When the cursor is not on a text slot with an @ field in it, the slot shows 
the value of the @ field. When the cursor is moved onto the slot, the 
actual @ identifier is shown, for editing. 
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The Diary reference 



The Diary application can be entered from the Index menu or from any 
application by typing DD. Only one copy of the Diary can exist in the list 
of SUSPENDED ACTIVITIES at any time. 

The Diary displays the Diary page for the current date, or the page 
previously edited if there is one. 



DIRRY 


■ 


DIRRY DhTE 1 


ELOCKS 

CURSOR 

EDIT 

FILES 




TUESDmY 
1 7TH 
MmRCH 
1 SS7 






INSERT 

MODE 



Text can be typed into the diary in a free format, and can be edited 
using similar cursor-editing facilities as in PipeDream. Text 
automatically wraps to the next line when it reaches the right-hand 
margin, but note that unlike PipeDream the Diary does not reformat the 
remaining text on the page. This is to avoid altering the layout of any 
subsequent diary entries on the same page. 

The key can be used to escape from any menu option. 

If you call the Calendar from within the Diary, you can use the cursor 
keys to select a new date. Pressing [ESC] then returns you to the Diary 
which will now display the page for the new date selected. (See Using 
the Calendar and Diary together, p. 68, for details.) 

Similarly, if you call the Alarm popdown from the Diary, the date will 
initially be set to the current date in the Diary. When you return to the 
Diary, however, the same date will be displayed on the screen as before 
the Alarm was called. 

Memory low warning 

When memory is low, a warning is displayed in the d i rry date 
window. You should then free memory before proceeding by deleting 
obselete diary entries with the OIdelI command. 






Operations on a block of text - BLOCKS 
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The commands on the BLOCKS menu allow you to perform a command 
on a block of text with a single operation A marked block can consist of 
a single line, can include several lines within one day, or can extend 
over several days, months, or even years. 

To mark a block give the Mark Block command on a line to be selected, 
or at the top and bottom of an area to be selected. The marked block will 
be displayed highlighted on the screen. 

Mark Block - OZ 

Marks a line, or the first and last lines in a block of lines, prior to 
performing one of the block operations on the entire block. 

Clear Mark - OQ 

Clears any marked block previously set up with the Mark Block 
command. 

Copy -OBC 

Makes a second copy of all the text within a marked block, putting the 
copy on the day indicated by the cursor position. 

Move -OBM 



Moves a marked block of text from one position in the Diary to the 
position indicated by the cursor. 
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Searching and replacing 



Delete - OBD 

Deletes a marked block of text from the Diary, closing up the gap. Note 
that this text cannot be recovered - the command should be used with 
caution. 

List - OBL 

Lists all or part of the diary to the screen, or to a printer. 

The following options are displayed: 

List on screen Yes 

List on printer No 

List only narked block Ves 

Pressing IentbrI will list the entire Diary to the screen. 

To list part of the Diary, mark the part you wish to list with the Mark 
Block command on the BLOCKS menu first. 

When listing to the screen the Diary will pause at the end of each 
screenful with the PRGE WAIT display: 

rrrm 

CONTINUE 

[S3 

RESUME 

Press the space bar to continue the listing or Use] to exit. 



The Search and Replace commands allow you to search for information 
anywhere in the diary and, if you wish, replace it throughout by 
different text. 

Whenever the Diary is performing a time-consuming task, such as 
searching through a huge amount of information, or performing a large 
number of replacements, the cursor will disappear. 

Search - OBSE 

Searches for a specified string, and moves to the day containing the first 
occurrence. You can restrict the search to a marked block, and also print 
or list all the lines which match the search string. 
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The following options are displayed: 

STRING TO SEARCH FOR 



EQUATE UPPER AND LOWER CASE YfJ 

SEARCH ONLY MARKED BLOCK No 

PRODUCE LIST No 

PRINT LIST No 



For example, if you identify every expense claim in your diary with the 
prefix ‘EX:’, you could search for or print out all the expenses by 
entering EX : as the string to search for. 

Equate upper and lower case: by default the case is ignored so that 
specifying the will find T h e T H E , etc. Change to no to find only strings 
that match the case of the specified string exactly. 

Search only marked block : change to V es to restrict the search to a 
marked block. 

Produce list /Print list: change to Ves to produce a list of the found 
strings to the screen or printer respectively. This is useful for finding 
and printing all lines begi nnin g with the same word, such as Meeti ng. 

Next Match - OBNM 

Moves from the cursor position to the next occurrence of the string you 
are searching for. 

Previous Match - OBPM 

Moves from the cursor position to the previous occurrence of the string 
you are searching for. 

Replace - OBRP 

Allows you to replace each occurrence of a string you are searching for 
with other specified text. By default the case of the replaced string is 
altered to match the case of the string matched, and before each 
replacement you are asked whether you want to make it. You can 
restrict the replacements to a marked block. 



Operations on a block of text - BLOCKS 
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Gives the prompts: 

STRING TO SEARCH FOR 

STRING TO REPLACE WITH 



EQUATE UPPER AND LOWER CASE YtS 

ASK FOR CONFIRMATION Ye-S 

SEARCH ONLY MARKED BLOCK No 



Replace with: specifies the string to replace every occurrence of the 
string to search for. 

Equate upper & lower case : only affects the search part of the string, 
and the string is replaced exactly as specified. 



The other options operate in the same way as for the Search command. 




Moving around the Diary - CURSOR 
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The commands on the cursor menu enable you to move the cursor to any 
position on the page of information for the current day in the diary, and 
to the next or previous day. 

TAB - Itab] 

Inserts spaces to position the cursor at the next tab position to the right. 
There are preset tab positions preset every 8 characters across the line. 

ENTER - [ENTER] 

Moves the cursor to the beginning of the next line. 

Save Position - OCSP 

Saves the current cursor position. If you move to a new position, you can 
jump back to the previous position with the Restore Position command. 
Up to five positions can be saved, and they will be restored in turn. 

Restore Position - OCRP 



Moves the cursor to the last position saved. 
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Moving within a line 



Moving within a day 



Cursor Right - O 

Moves the cursor one character space to the right. 

Cursor Left - O 

Moves the cursor one character position to the left. You cannot move 
past the beginnning of the line. 

Next Word - [shift! d> 

Moves the cursor to the beginning of the next word on the current line. 
Previous Word - [shift! O 

Moves the cursor to the beginning of the previous word on the current 
line. 

End of Line - OO 

Moves the cursor to the character position after the last character on the 
current line. 

Start of Line - 0O 

Moves the cursor to the first character position in the current line. 



Cursor Down - 0 

Moves the cursor down within the current day. 

Cursor Up - 0 

Moves the cursor up within the current day 

Last Line - 

Moves the cursor to the last line on the current page. 

First Line - <>0 

Moves the cursor to the first line on the current page. 
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Screen Down - IshiftI 0 

Moves the cursor down by a screenful of information. 
Screen Up - IshiftI 0 

Moves the cursor up by a screenful of information. 



Moving between days Today - OCT 

Moves the cursor to today. 
Next Day - nO 
Moves to the next day. 
Previous day - 
Moves to the previous day. 



Active days Days in the Diary which contain information are referred to as 'active' 

days. You can move rapidly between the active days with the Next and 
Previous Active Day commands, and you can find the latest and earliest 
information in the Diary with the Last and First Active Day commands. 

If you call the Calendar from the Diary, active days, and the day you are 
currently looking at, are indicated by a marker against the day: 

14 H5 16 

Next Active Day - 

Moves to the next day containing an entry. 

Previous Active Day - □<□ 

Moves to the previous day containing an entry. 

Last Active Day - OCLAD 

Moves to the latest day containing any information. 



Moving around the Diary - CURSOR 1 69 

First Active Day - OCFAD 

Moves to the earliest day containing any information. 

Summary of Diary cursor operations 
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Editing the Diary - EDIT 
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Editing within a line insert/Overtype - ov 

Switches the text entry mode between Insert mode, in which characters 
typed are inserted at the cursor position, and Overtype mode, in which 
characters type over the previous contents of the line. 

The current mode is displayed at the right-hand side of the screen in the 
DIfiRY dote window. 

Delete Character - OG or IshiftI [Ml 

Deletes the character at the cursor position. All characters to the right of 
the cursor will move one position to the left to close up the gap. 

Delete to End of Line - OD 

Deletes the text from the cursor position to the end of the line. 

Delete Word - OT 

Deletes all characters from the cursor position to the beginning of the 
next word. If you position the cursor at the beginning of a word before 
giving this command, it will delete the word. 

Rubout - (del] 

Deletes to the left. In Insert mode all characters at and to the right of the 
cursor will move left. 









Editing the Diary - EDIT 
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Insert Character - <>U 

Inserts a blank space at the cursor position. 

Swap Case - OS 

Changes the case of the character at the cursor position and moves the 
cursor to the next character. 



Editing within a day Delete Line - OY or oIdel! 

Deletes the current line. Text on subsequent lines is moved up one line 
to close up the gap. 

Join Lines - OEJL 

Adds the text on the next line to the end of the text on the current line. 

Insert Line - ON 

Inserts a blank line at the cursor position. The text on the current line 
and all subsequent lines is moved down one line. 

Split Line - OESL 

Splits the current line at the cursor position. All characters at, and to the 
right of the cursor, will be moved to the next line. 



Miscellaneous Memory Free - OEMF 

Displays the amount of space available, in bytes, in the d i rry dote 
window on the right-hand side of the Diary screen. Each byte represents 
the space needed for a character; approximately 2000 bytes are needed 
to store a typical A4 page of text. 

Next Option - ❖ J 

Alternates between the available values of an option. 



Loading and saving - FILES 
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The commands on the FILES menu allow you archive old information in 
the Diary, or to load a range of entries into the Diary, starting at a 
different date (such as a year later). 

Load - OFL 

Incorporates a diary file of a specified name into the information 
currently in the Diary. 

Gives the prompts: 

NOME OF FILE TO LORD 



STRRT LORDING DRTR RT DIRRY DRTE No 

A block of Diary entries can be copied from one range of dates to 
another, such as from one year to the next, by saving the block, moving 
to the same date in the next year (using the Calendar), and then loading 
the data back with the option set 

STRRT LORDING DRTR RT DIRRY DRTE V 

Because loading appends data to whatever is already in the diary, an 
additional blank line will be present on the current day after a load. 

Instead of typing the file name, the file can be selected from the Filer. 
After typing OFL call the Filer by typing OF, and select the required file 
by marking it (see Selecting files, p. 83). When you return to the Diary 
from the Filer by pressing [esc] the selected file name will have been 










Loading and saving - FILES 



copied to the Load window. You will then just need to press IenterI to 
load the file. 
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Save - OFS 

Saves the Diary to the current name, or to a name you specify. Normally 
the whole diary is saved. You can also save part of the Diary by marking 
the block of text first. 

Gives the prompts: 

NAME OF FILE TO SAVE 

SAVE ONLY MARKED BLOCK No 




Section Seven Filer reference 



This section describes the more advanced features of the Filer popdown, 
and should be read in conjunction with the Filer description in Section 
Three. The features described here include: 

■ Directories, and the hierarchical filing system 

■ The Command Line Interpreter, and CLI files 



Specifying file names in full The full form of a file name is 

: DEVICE/DIRECTOR Y/DIBECTOR Y/ .... /filename 
where DIRECTORY and filename are each of the form 
name. extension 

consisting of a name of up to 12 letters or digits, followed by an optional 
extension of up to three letters or digits, 

The following extensions are used for system functions: 

. s gn For n+K and n+S CLI files 

.CLI For BOOT.CLI; see CLI files, p. 179. 

. L For PipeDream multi-file List file 

DIRECTORY is a directory name subject to the same constraints as 
filename. 

In addition the following symbols can be used: 

../ name Parent directory of name 

Current directory 




Note: RAM . - files must be deleted before a soft reset is performed with 
Operating Systems up to and including 3.0. 

Wildcards 

The device, directory and file name can contain the following wildcards: 

* Matches any number of characters (or none) 

? Matches a single character 

/ / Matches any number of directories (or none) 

For example, 

:*// letter Finds the file called letter anywhere 
doc* Finds: doc . tx, document, doc27, doc, etc. 

* . * Finds only files with extensions. 

. . / f r e d * Finds all files beginning with f r e d in the parent 

directory 



Note that the characters 7’ and ‘\ ’ may be used interchangeably. 
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Additional Filer commands The following commands provide facilities for creating directories, 

manipulating files within the hierarchical directory structure, and 
executing files of commands. The files referenced by commands such as 
Select directory or Execute can be selected by marking them; see 
Selecting files, p.83. 
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Select Directory - OSI 

Sets the current directory to the specified directory. Gives the prompt 
Name : ■ 

displaying the current directory string (if any). 

For example, to set the current directory to directory TEXT in the current 
directory, specify 

Name : TEXT 

If the directory has not been created, a F i 1 e not found error will be 
displayed. 

Select Device - OSV 

Sets the current device. Gives a prompt such as 

Name : :RflM,0 

showing the current device, which can be edited to the required new 
device. 

The Select Device command resets the current directory to the root 
directory. 

The Select Device and Select Directory commands affect the device and 
directory for the activity from which the Filer was entered, if there is 








178 



Section Seven - Filer reference 



one. This allows different activities to use different devices and 
directories without the need for specifying them explicitly each time. 

Note, therefore, that if you save files having set a device and/or directory 
from one activity, and then enter the Filer from another activity, the files 
may not appear in the DIRECTORY list. Check the directory displayed at 
the top of the DIRECTORY window to ensure that you are in the 
intended directory. 

Down Director y - [SHIFT! O 
Up Directory - ISHIFTI 

These commands are used for traversing a hierarchical directory 
structure. To select a directory move the highlight bar to the directory 
name in the Filer DIRECTORY window and press [shift! -0 . To go back up 
to the parent directory press [shift! 0 . 

Execute - <>EX 

Executes a CLI file of commands specified after the prompt 

Nane : I 

See CLI files below. 

Create Directory - OCD 

Creates a directory within the current directory; the name is specified 
after the prompt 

Nane : I 

Tree Copy - OTC 

Copies a file tree from one directory to another. Arguments to the 
Source and Destination fields must be devices or directories. For 
example, 

Source : : RAM , 1 
Destination : :RAM,2 

will make a duplicate copy of all files from RAM card 1 to RAM card 2. 
The source area cannot be part of the destination area. 
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Name Match - ONM 

Sets up a match string restricting access to files in the current directory 
to those that match the string. For example, setting 

Name : * ■ bas 

will catalogue only files with a bas extension. The default match string 
is *, matching all file names. When a name match other than * is active, 
the symbol nm will be displayed at the left-hand end of the Filer 
DIRECTORY window. 



CLI files The Filer Execute command, <>EX, allows a text file to be passed to the 

Command Line Interpreter, or CLI. The effect is as if the characters in 
the file had been typed at the Z88 keyboard. CLI files thus provide a 
means of specifying a sequence of commands or operations, which can 
then be carried out simply by executing the file. For example, an execute 
file could be used to carry out a frequently-used sequence of Replace 
operations in PipeDream documents. 

Certain characters are given a special significance in CLI files, to allow 
special keys on the keyboard to be represented, or additional operations 
to be carried out by the Command Line Interpreter. 

These special characters, and their functions, are as follows: 

# Prefixes a □ key sequence 

! Prefixes a <> key sequence 

Used in combination with a letter to represent other special keys 
on the Z88 keyboard 

As the first character on a line, introduces a special CLI 
command. 

To represent these actual characters in a command file, they should be 
specified twice: 



Sequence 


Represents 


## 

I 1 

1 1 


# 

1 

1 
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Key sequences 



Character 


Significance 


~A 


Single press of the □ key; ~A~A has no effect 


~C 


Single press of the 0 key; ~C~C has no effect 


~S 


[shift! 


-I 


[INDEXI 




[menu) 


~H 


[HELP| 


~E 


lENTERl 


~X 


US 


~T 


[tabI 


~U 




~D 




~L 


<P 


~R 


o 


: : 


JH] 



File control commands 



The full-stop character introduces the following special commands when 
it is the first character of a line in an execute file. 



Sequence 


Significance 


,T> filename 


Create output file 


,T< filename 


Create input file 


,T= filename 


Create printer file 


.> filename 


Redirect output 


.< filename 


Redirect input 


.= filename 


Redirect printer 


.D nnn 


Delay nnn centiseconds 


.S 


Suspend CLI; all redirections of input or output 
remain in force 


.* filename 


Invoke new file to CLI 


.J 


Ignore special significance of subsequent escape 
characters 


. ; a comment 


Ignored. 



The T character represents a ‘T’ junction, as it causes an additional 
copy of the input or output to be sent to a specified stream. For 
example: 



. T> : RAM . 0/f red . txt 
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sends a copy of what is going to the screen to the file 
: RAM . 0/f red . txt 

The J character stands for ‘Jam’, as it inhibits interpretation of the 
escape characters. 

Printer output can be spooled to a file with the '=’ symbol. For example, 
.= : RAM . 0/pri ntout 

takes the text that would have been printed out, before printer codes are 
added, and puts the text into the file 

: RAM. 0/pri ntout 

Terminating execute files 

When the CLI is running an execute file a CLI symbol is displayed in the 
OZ area of the screen. The current CLI can be terminated by pressing 
IshiftI IescI . If several CLIs are running they can all be terminated by 
holding down <> and pressing Use] , 

Redirecting keyboard input and screen output 

The following key combinations can be used to redirect keyboard input 
and screen output: 



Key 


Effect 


□+P 


All screen output also sent to the printer 


□+S 


All screen output also sent to the file : RAM . -/S.sgn 


□+K 


Key input also sent to the file : RAM .-/K.sgn 



For example, a+P can be used to obtain a catalogue of EPROM or RAM 
to a printer. 

The corresponding sequences with turn the facility off, and 
sequences o+P and D+S are mutually exclusive. 

The commands a+S and D+K generate files K.sgn and S.sgn in 
temporary RAM. These should be deleted after use with the Filer Erase 
command. 
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Editing BASIC programs using PipeDream 

BASIC programs are saved in a tokenised format, and so cannot be 
loaded into PipeDream and edited directly. However, the CLI provides a 
convenient way of obtaining a text listing of a BASIC program, which 
can then be edited and executed back into BASIC. 

The procedure is as follows: 

© LIST the program to the file : R AM . - / S . s g n by typing 
LIST D+S [ENTER] 

© When the listing has finished, close the file by typing 
□ -S 

The file :RAM.-/S.sgn can be loaded into PipeDream as plain text, 
and edited. 

(D Add the characters 

.J 

NEW 

at the start of the file, and save it from PipeDream using the Plain 
text option. 

© Execute the edited file back into BASIC by entering BASIC and 
typing: 

*CLI . *FI LENAME 

to invoke the CLI to execute the file. 

© When finished, erase the file : RAM . - / S . s gn using the Filer. 

The . J at the start of the file avoids the need to replace characters such 
as # by ## throughout the BASIC program so that they will not be 
interpreted by the CLI. 
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Executing a file on reset 

On resetting the Z88, if a file with the name 
BOOT . CLI 
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exists on an EPROM card in slot 3 , it will he copied into 
: RAM. -/BOOT. CLI 

and then executed. The file should be deleted when it is no longer 
required. 



I 

I 
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Section Eight The Terminal 



The Terminal application provides a widely-used VT52 standard for 
communicating between a Z88 and another computer, or between two 
Z88 computers, over the RS232 serial line. 

The Terminal can be entered from the Index APPLICATIONS menu, or 
by typing nv. You can leave the Terminal by pressing the [shift 1 and 
[enter i keys together. 

Serial port settings 

The serial port parameters can be configured from the panel which is 
entered with nS; see Panel options, p. 87. 



Control keys The equivalent Z88 keys for the VT52 control keys are shown in the 

following table, together with a list of the codes transmitted: 



VT52 


Z88 


Codes sent 


DELETE 


[DEL] 


$7F 


BACKSPACE 


ISHIFTllDELl 


$08 


UP 


0 


ESC A 


DOWN 


0 


ESCB 


RIGHT 


o 


ESC C 


LEFT 


o 


ESC D 


FO 


[SHIFT] <□ 


ESC P 


FI 


ISHIFTIO 


ESC Q 


F2 


ISHIFTlO 


ESC R 


F3 


iSHIFTin 


ESCS 


CONTROL 


o 


- 



These functions are provided on the Terminal COMMANDS menu, with 
the following additional command: 

Exit - [SHirfl [ENTER] 

Removes the terminal and returns to the Index. 



From the Index, OKILL is preferred. 
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Spooling files 



Transmitting files 



Material received by the Terminal application can be spooled to a file 
:RAM.-/S.sgn automatically by typing n+S before commencing the 
transfer. The file will be created in temporary RAM, and should be 
deleted after use. 

Spooling can be disabled by typing □ - S . 



A convenient way of sending a file to a remote machine is to copy the 
file to the : COM device. 

Enter the Terminal and establish contact with the remote machine in the 
usual way, and then type nF to go into the Filer. 

Select the file you wish to transmit and then choose Copy from the Filer 
menu (see pp. 83-85 for details of how to select and copy files). A 
dialogue box will appear. Type in : COM as the destination and press 
[ enter I . The file will then be transmitted. 

Once the transmission is over the dialogue box will disappear leaving 
the Filer display on the screen. You may then press [esc) to return to the 
Ter min al. 




Section Nine The Printer Editor 



With PipeDream you can create documents containing highlight codes 
that specify particular type styles and effects, such as bold and 
underlined text, superscripts and subscripts, and alternative fonts. 
Because different printers use different techniques to achieve these 
effects, the Z88 uses a printer driver to convert the standard PipeDream 
highlights to each particular printer’s codes. The printer driver can then 
be altered to suit a particular printer’s facilities. 

The Z88 comes with a built-in driver, which interfaces with the widely- 
used Epson series of dot-matrix printers, or other printers compatible 
with this. 

Creating a new printer driver 

The Z88 Printer Ed application allows you to create your own printer 
driver definition, editing the options used by the built-in driver to add 
your own special printing effects to your documents. 

Alternatively, you can design a printer driver definition for a make of 
printer not catered for by the built-in driver. To do this you will need to 
consult the printer handbook, to find out which codes are needed for 
each facility you want to use. 

Having created a new printer driver definition, you can use this to 
replace the built-in driver with the Update Driver command. 

To run the editor select PrinterEd from the Index APPLICATIONS list, or 
press QE from any application. 

The driver definition is displayed on two pages. You can move between 
the pages with the following commands: 

IshiftI 0 move from page 1 to page 2 

IshiftI 0 move from page 2 to page 1 . 

While developing and testing a printer driver it is sensible to keep 
PrinterEd as a suspended activity. On completing a driver definition, and 
saving it to the filing system, the PrinterEd activity can be deleted from 
the Index with OKILL. 
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Editing the driver definition The printer driver definition is altered by moving the cursor to the 

appropriate field on the page with the cursor keys, 0,0,0, or O, 
and then typing the required value for the option. The editing 
commands are summarised on the PrinterEd CURSOR menu. 

Some options take a Yes/No value; in this case you can toggle between 
the values with the Next Option command, O J, or select the appropriate 
value by typing Y or N . 

Most options take a list of one or more codes, separated by commas. 

Code values 

Printer codes can be entered in any of the following forms: 







Example 2 


Decimal number 


90 


27 


Hexadecimal number 


$5A 


$1B 


ASCII character 


"Z" 




ASCII symbol 




ESC 



The two examples show equivalent representations of the same values. 

Any of the standard ASCII symbols can be used to represent the values 
0 to 3 1 , or $0 to $1F. A full list is given in Appendix D - Z88 Character 
Set. 



Highlight codes Page 1 of the PrinterEd application allows the behaviour of each of the 

eight PipeDream highlight codes to be specified. 



PRINTERED 

CURSOR 

FILES 



k a 



mm? 




1 OH Underline 27,45,1 

2 String Bold 27,69 

3 Ext. sequence 

4 i tal ics 27,52 

5 Subscript 27,83,1 

6 Superscript 27,83,0 

7 Hi t . f ont 1 5 

8 User defined 27,120, 1 



OFF 


27,45,0 


Off 


Ves 


Str ing 


27,70 


at 


Yes 






CR 


Ves 




27,53 




Ves 




27,84 




Ves 




27,84 




Ves 




18 




No 




27, 120,0 




No 



The recommended assignment of highlight codes to printer functions is 
as follows: 
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Code 


Function 


Printed example i 


1 


Underline 


underlined type 


2 


Bold 


bold type 


3 


Extended sequence 


e g 7c 


4 


Italic 


italic type 


5 


Subscript 


h 2 o 


6 


Superscript 


e=mc 2 


7 


Alternative font 


alternative font 


8 


User defined 





In every case the same highlight turns the facility off, and in all cases 
except 7 and 8, the facility is also turned off at the end of a slot. 

The highlight table contains three columns specifying the following 
information for each of the eight highlights, 1 to 8: 

ON String The sequence of codes needed to turn the facility on 

OFF String The sequence of codes needed to turn the facility off 

Off at CR Ye- s or No , to determine whether the facility should be 
cancelled at the end of a slot. 

You can move between columns using the cursor keys O and O, and 
between lines with 0 and 0 . 

ON String and OFF String 

The ON String specifies the sequence of codes to turn the corresponding 
printer facility on, and the OFF String the sequence of codes to turn it 
off. Each of these sequences of codes is output on alternate occurrences 
of the specified highlight code in the document. 

If the facility is toggled on and off by the same sequence of codes, the 
OFF String can be omitted, and the ON String will be output on every 
occurrence of the highlight. 

Overprinting 

On some printers special effects can be obtained by outputting a 
sequence of codes for every character printed. For example, some daisy- 
wheel printers underline by backspacing, and then printing an 
underscore character, for every character printed. 
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You can set up highlights that work on this principle by including the 
special '?' character in the ON String. When the highlight is active, the 
specified ON String sequence will be output for every character printed, 
with '?’ replaced by that character. This facility is toggled on and off by 
successive occurrences of the specified highlight code. 

For example, to underline by backspacing and overprinting an 
underscore character, give the sequence 

1 ON Underl ine ?,BS, 

If '?’ occurs in the ON String the OFF String is ignored, and should be 
left blank. 

Off at CR 

The final column specifies for each code whether the facility should be 
turned off automatically at the end of each slot. In general, all highlights 
which are normally inserted on a word by word basis, such as 
underlining and bold type, should specify Y es (the default) in this 
column. 

Off at CR should also be set to Y es if the printer itself turns off the 
corresponding facility at a carriage return. 

Off at CR should be set to N o in the case of highlights, such as 
alternative font, which are applied to a large section of a document. Note 
that in this case headers and footers within the highlighted area will 
also be affected. 
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Printer options Page 2 of the PrinterEd application allows the driver definition options to 

be specified, and up to nine character translations to be set up. 



PRINTERED 

CURSOR 

FILES 



“ mm- * 



Epson 



Printer on 27,64 
Printer off 
End of page 12 
R1 low 1 ine feed Ves 
HMI : Prefix 
Suffix 
Offset 



Translat ions 
Character 
Changes to 
Character 
Changes to 
Character 
Changes to 



IfiP 



27,82,3, 



OZ 



Printer on 

Specifies a sequence of codes to be sent to the printer before printing a 
document. For example, the codes 27,64 in the Epson driver definition 
initialise the printer. 

Printer off 

Can be used to reset the printer to its previous settings so that 
subsequent printing will not be affected. 

End of page 

Specifies a sequence of codes to be sent to the printer at the end of each 
page. If the sequence contains a form-feed character, 12 (or FF), 
PipeDream will not output linefeeds to the end of page, resulting in 
faster and quieter page ejects on printers that support this. 

Allow line feed 

Determines whether a line feed code (LF) is sent at the end of each line, 
in addition to a carriage return (CR). This option is set to Yc s in the 
default Epson driver. If unwanted extra line feeds are produced, so that 
all printing is double-spaced, change the option value to No . 

Note: With Operating Systems 3.0 and earlier, selecting No will cause 
ASCII 0 (NULL) to be sent instead of ASCII 10 (LF). 

Microspacing - HMI 

Certain printers allow the horizontal movement of the print head to be 
controlled to l/120th of an inch, which mens that text will be justified 
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with an almost perfectly even distribution of the space. The following 
sample is printed without microspacing: 

This sample of text demonstrates the 

improvement gained by justifying text with 
mi crospaci ng . 

The same sample with microspacing is shown below: 

This sample of text demonstrates the 

improvement gained by justifying text with 
mi crospaci ng . 

Microspacing requires a Horizontal Motion Increment, or HMI, to be 
specified to the printer as the number of 120ths of an inch to be 
allocated to the printing of subsequent characters. This is normally 
given after a prefix code, although for some printers a suffix is also 
required. For example, the Ricoh, Flowriter 1600, and JUKI 6100 use the 
following prefix: 

HMI prefix ESC, 31 
HMI suffix 
HMI offset 1 

Translations 

The character translation table allows up to 9 single-character 
substitutions to be made before printing, so that alterations can be 
made to the character set supplied by the printer. The sequence may 
include a string of codes, which will scroll within the window as they 
are entered. 

For example, the default Epson driver uses the following sequence to 
print a '£' sign, assuming it is set up to use the USA character set: 



27,82,3,35,27,82,0 



which is equivalent to: 

E S C , " R " , 3 select UK character set 
3 5 print pound sign 

E S C , " R " , 0 restore USA character set 
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PrinterEd FILES menu The PrinterEd FILES menu provides commands to allow driver 

definitions to be used for subsequent printing, or to be saved and loaded 
as named files. You can also reset the driver definition to the standard 
Epson driver. 



PRINTERED 


Load 


«FL 




■si 


oz 


CURSOR 


Save 


oFS 




RDURNCE 




FILES 


Name 


OFC 




<> ^ ■!> V 




New 


oFNEU! 




SELECT 






Update Driver 


oFU 




Ill'll LI 
RCTION 

[S3 

RESUME 







The name of the current driver definition, initially Epson, is displayed on 
the Printer Editor screen and is shown for the PrinterEd activity m the 
Index YOUR REF. column. 

Load - OFL 

Allows a driver definition to be loaded into the Printer Editor. Gives the 
prompt: 

Filename I 

Note that the driver definition is not actually installed until the Update 
Driver command is given. 

Save - OFS 

Saves the current driver definition with a specified name. 

Name - <>FC 

Sets the name of the current dnver definition. 

New - OFNEW 

Resets the driver definition in the Printer Editor to the options for the 
default Epson driver, and resets the driver used for printing to this 
driver. 

Update Driver - OFU 

Creates a printer driver from the definition currently in the Printer 
Editor, and installs it for use in subsequent printing. 









Section Ten BBC BASIC 



PipeDream can be used to carry out most of the operations you are likely 
to want to perform on text and numbers, such as entering and editing, 
searching, sorting and calculating. However, some problems would 
require you to carry out a sequence of different operations and this 
might be cumbersome and time-consuming using PipeDream. For this 
sort of problem you can turn to the BBC BASIC programming language 
which is provided in your Z88. 

Programming languages are designed to allow you to instruct the 
computer to cany out a sequence of operations on text or numbers. 
BASIC is one such general-purpose programming language, and is the 
most widely used language on microcomputers. BASIC has a significant 
advantage over many other languages in that it is interactive: you can 
make changes to a sequence of instructions, and see the result 
immediately without having to perform any intervening operations. This 
means that programs can be developed relatively quickly. 

This section provides a reference list of all the Z88 BBC BASIC language 
keywords. It is not intended as a tutorial on the BASIC language; many 
excellent books on this subject already exist. 

The keywords are divided into four types: 

Commands are instructions that can be typed from the keyboard to 
assist in creating a program, and testing it out. Commands are typed 
from the keyboard in immediate mode after the BASIC > sign prompt, 
and they may not be used within programs. 

Statements are the special keywords that are used within programs, 
after a line number, to instruct the computer to do something. Most 
statements can also be typed directly after the BASIC prompt, and are 
then executed immediately so that you can try out their effect. 

The BASIC statements are normally the first keyword after the line 
number in a program line. 

Functions can be included in expressions, and will return the result of 
performing an operation on the arguments enclosed in brackets after 
their name. They are similar to the functions in PipeDream. 
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A function can be followed by one or more arguments, and returns a 
number or a string. Functions which take only one argument require 
brackets around the argument only if it is a complex expression. If the 
argument is a simple number, variable, or another function, no brackets 
are required. 

Finally, the operators can be used to link the components of 
expressions. 

The following keywords, associated with graphics, sound, and analogue 
operations in other versions of BBC BASIC, give the error 

Sorry, not implemented 

on the Z88: 

Graphics: CLG, COLOUR, DRAW, GCOL, MODE, MOVE, PLOT, POINT 
Sound: ENVELOPE, SOUND 
Analogue: ADVAL 



Entering BBC BASIC You enter BBC BASIC by selecting BASIC from the Index 

APPLICATIONS LIST, or by typing DB from any application. The initial 
BASIC screen will then be displayed: 



BASIC 


BBC 


BfiSIC CZ80) Uersion 3.00 


OZ 




CO 


Copyr i 9 ht R.T. Russell 1987 






>1 


CHP5 





In an unexpanded machine, BASIC has a workspace of 8K bytes. In an 
expanded machine, containing in slot 1 at least 128K RAM, the 
workspace is increased to 40K. 
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Entering keywords Many keywords may be abbreviated when entered into a program, and 

will be expanded by the BASIC interpreter. In such cases the shortest 
abbreviation is shown in brackets after the full form; eg AUTO (AU.). 

All keywords must be entered in capitals, as shown in the following 
al phabetic al list. Inverted Caps mode can be selected by typing 
□ iCAPSLOckl . To give capital letters when the Z88 k eys are type d alone, 
and lower-case letters when typed with the IshiftI key. Press o |capslock| 
to restore ordinary Caps mode. 



Editing BASIC programs The following program provides BBC BASIC on the Z88 with a line 

editor. The line editor works as follows: 



® To edit a line you need to type: P ROC E ( 7 7 r?e number) [ENTERi 
The editor will list out the line and put the cursor at the end. 

® You can now use the cursor keys to move within the line and make 
changes, and most of the edit commands available in PipeDream 
such as Delete Word etc. 

(D When you have made all the changes you want, press I enterI to store 
the line back in the program. If you want to abandon the changes 
you have made then press Use] and the line will be left unchanged. 

Before you can use the editor you must type in the following program. 

You can then start writing your own program. When you save your 

program the editor will be saved with it. 



60000 END 

60010 DEF PROCE(B) 

60020 REM Cambridge Computer Ltd. 

60030 IF B=0 THEN ENDPR0C 
60040 A=0PEN0UT" : RAM .0/EE.CLI" 

60050 B$=" : RAM . 0/ E . CLI " 

60060 PRI NT#A , " . > "+BS 

60070 PRI NT#A , " . J " , " LI ST"+STRS ( B ) , "PR0CF 

60080 CLOSED 

60090 *CLI RAM. 0/EE.CLI 

60100 ENDPR0C 

60110 DEF PR0CF 



60120 A=I N KEY ( 0 ) 

60130 A=0PEN I N B$ 

60140 I NPUT#A . AS , AS 
60150 CL0SE#A 
60160 A=0PEN0UT B$ 

60170 PRI NT#A , " . J " , AS 
60180 PTR#A=PTR#A- 1 
60190 BPUT#A . 0 
60200 CL0SE#A 
60210 VDU 8 

60220 0SCLI"*CLI ,<"+BS 
60230 ENDPR0C 
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Printing from BASIC 



If you have several existing programs which you would like to append 
the editor to you must type the editor into PipeDream. On the first line 
you must include the CLI command J . Now save the file in plain text 
format as EDBAS. When you want to use the editor start a BASIC and 
load the program you want to edit. To append the editor onto the end of 
your program type: 

*CLI . *EDBAS [ENTER] 

where EDBAS should be in the directory selected by this application. 

Note that if your program uses line numbers above 60000 you should 
renumber it first before appending the editor. 

The editor generates two working files in :RAM.O called /EE.CLI and 
/E.CLI. The files can be erased after use. If you have a RAM card in slot 
1 or slot 2 you could alter the program to save its working files in 
:RAM.l or :RAM.2 by changing lines: 60040, 60050, and 60090. 



The following program shows how to print from a BASIC program: 

100 LET PRT_0N$=CHR$ ( 5 )+" [ " 

110 LET PRT_OFF$=CHR$ ( 5 )+" ] " 

120 LET LF$=CHR$ (10) 

130 : 

140 LET PRT=0PEN0UT” : PRT” 

150 IF PRT=0 THEN PRINT" CAN’T OPEN PRINTER ”:ST0P 
160 : 

170 PRINT# PRT, PRT_0N$ 

180 FOR 1=1 TO 4 

190 PRINT#PRT, "Text ”+STR$ ( I*PI )+” and numbers ! "+LF$ 
200 NEXT I 

210 P R I NT#P RT , P RT_0 F F $ 

2.20 : 

230 CL0SE#PRT 

When run it prints the following: 

Text 3.14159265 and numbers! 

Text 6.28318531 and numbers! 

Text 9.42477796 and numbers! 

Text 12.5663706 and numbers! 



BASIC keywords 



ABS Absolute value (function) 

Returns the absolute positive value of its argument. 

ACS Arc cosine (function) 

Returns the arc cosine of its argument in radians. The permitted range 
of the argument is -1 to +1. 

For example, 

PRINT DEG ( ACS ( 0.5)) 

will print 60, because COS(60°) is 0.5. 

AND (A.) Logical AND (operator) 

Performs a bitwise logical AND between two operands which are 
internally converted to 4 byte integers before the operation. 

It is normally used to join two conditions in an IF or UNTIL statement; 
thus 

IF length >10 AND width > 10 THEN PRINT "OK" 
ensures that a rectangle is larger than 10x10. 

ASC ASCII value (function) 

Returns the ASCII character value of the first character of the argument 
string. 

PRINT ASCCZ88") 

gives 90, the ASCII value of "Z". 

The brackets are optional, and ASC" ", the null string, gives -1. 
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A SN Arc sine (function) 

Returns the arc sine of its argument in radians. The permitted range of 
the argument is -1 to +1. 

ATN Arc tangent (function) 

Returns the arc tangent of its argument in radians. 

AUTO (AU.) Automatic numbering (command) 

Allows lines to be entered without first typing in the number of the line. 
The line numbers are preceded by the usual prompt (>). 

By default the starting line number and increment are both 10, but they 
may optionally be specified; for example 

AUTO 20 



will start with line 20, and 

AUTO 100, 20 

will start at line 100 and increment by 20. AUTO will continue 
generating line numbers until you press Esc] . 

BGET# (B.#) Byte from data file (function) 

Returns a byte from the data file whose channel number is its argument. 
The file pointer is incremented after the byte has been read. For 
example, 

character=BGET#c 

reads the next character from file c. 



BPUT# (BP.#) Output a byte (statement) 

Puts a byte to the data file whose channel number is the first argument. 
The second argument's least significant byte is written to the file. The 
file pointer is incremented after the byte has been written. Thus 

BPUT#channel , char 



writes char to file channel . 
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CALL (CA.) Call machine-code (statement) 



Calls a machine code subroutine at a specified address, passing 
parameters in a parameter block addressed by the Z80’s IX register. The 
IY register is set to the address of the machine code subroutine being 
called. The processor’s A, B, C, D, E, F, H, and L registers are initialised 
to the least significant bytes of A%, B%, C%, D%, E%, F%, H%, and L% 
respectively. 

This statement could cause corruption of the Z88 memory, and should 
therefore only be used by experienced programmers. 



The parameter block contains the following list: 



number of parameters 
first parameter type 
first parameter address 
parameter type 
parameter address 



1 byte (IX+0) 

1 byte (IX+1) 

2 bytes (IX+2.IX+3) 

) repeated as often 

) as necessary 



Parameter types 



0 8 bit bytes (eg ?a) 

4 32 bit integer variable (eg !b or c%) 

5 40 bit floating point number (eg d) 

128 A string at a defined address (eg $e - terminated by a &0D) 

129 A string variable such as f$ 



In the case of a string variable the parameter address is the address of a 
String Information Block which gives the current length of the string, 
number of bytes allocated, and start address, in that order. 

mul d i v=l 234 

CALL muldiv,A,B$,C% 

CHAIN (CH.) Load and run program (statement) 

Loads and runs the program whose name is specified in the argument 
allowing one program to load another. Information can be passed 
between programs using the static variables @%, and A% to Z%. 
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CHR$ 



CLEAR (CL.) 



CLOSE# (CL.#) 



CLS 



COS 



COUNT (COU.) 



ASCH character (function) 

Returns the ASCII character string specified by the least significant byte 
of the numeric argument. 

A$=CHR$ ( 90 ) 

will set A$ to "Z", since ASC"Z" is 90. The characters corresponding to 
values 32 and above can be displayed on the screen with the line 

FOR N%=3 2 TO 255: PRINT CHR$ ( N% ) ; : NEXT 

Clear program (statement) 

Clears all variables, including strings apart from the static variables @ % , 
and A% to Z%. 

Close channel (statement) 

Closes a specified channel. For example, 

CL0SE#c 

closes channel c. 

Clear text area (statement) 

Clears the text area of the screen. The text cursor is moved to the ‘home’ 
position (0,0) at the top left-hand character position of the text area. 

Cosine (function) 

Returns the cosine of its argument in radians. 

X=C0S( angl e) 

Character count (function) 

Returns the number of characters sent to the output stream (VDU or 
printer) since the last new line. For example, 

PRINT A$ ; : REPEAT PRINT H .";:UNTIL COUNT = 72 

will pad the line with dots to 72 characters. 
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DATA (D.) 
DEF 



DEG 

DELETE (DEL.) 

DIM 



Data (statement) 

Introduces lists of data for use by the READ statement (see READ). 
Define function/procedure (statement) 

Precedes declaration of a user-defined function (FN) or procedure 
(PROC). DEF must be used at the start of a program line. 

For example, 

DEF FNcelsius(f) = (f-32)*5/9 

defines a function to convert Fahrenheit to Celsius. Executing 
PRINT FNcel si us ( 98 . 4 ) 

will convert 98.4 to Celsius. 

Degrees (function) 

Returns the argument converted from radians to degrees. For example 
PRI NT=DEG( P I / 2 ) 

will print 90. 

Delete lines (command) 

Deletes a group of lines from the program. Both start and end lines of 
the group will be deleted. For example 

DELETE 123,456 

will delete all lines between 123 and 456 inclusive, which need not exist. 

Dimension array (statement) 

Dimensions an array, or reserves an area of memory for special 
applications. For example, 



DIM a $ ( 10 , 20 ) 
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DIV 

ELSE (EL.) 

END 

ENDPROC 

EOF# 



dimensions a two-dimensional string array a$ with elements a$(0,0) up 
to a$( 10,20). Arrays may have one or more dimensions, and may he 
string arrays, floating-point arrays, or integer arrays. 

DIM X % 2 4 

reserves 25 bytes and puts the address of byte 0 in the variable X%. 

Integer divide (operator) 

Gives the integer quotient of two items. The result is always an integer. 
X=A DIV B 

y=( top+bottom+1 ) DIV 2 

Else clause (statement) 

An optional part of the IF. ..THEN, or ON...GOSUB/GOTO statements, it 
introduces the action to be taken if the testable condition evaluates to 
FALSE, or the ON expression is out of range. 

End program (statement) 

Returns to direct mode. 

End procedure (statement) 

Denotes the end of a procedure defined with DEF PROC. 

End of file (function) 

Returns -1 (TRUE) if the end of the specified data file has been reached. 
For example, 

REPEAT 

char%=BGET#data 
UNTIL E0F#data 

will read characters until the end of the file whose channel number is 
the variable data. 
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EOR 

ERL 

ERR 
EVAL (EV.) 

EXP 

EXT# 

FALSE (FA.) 



Logical Exclusive-OR (operator) 

Performs a bitwise integer logical exclusive-or between two operands 
which are internally converted to 4 byte integers before the operation. 

Error line (function) 

Returns the line number of the line where the last error occurred. For 
example, 

PRINT "Error number" ERR "at line" ERL 

Error code (function) 

Returns the error code number of the last error which occurred. 

Evaluate string (function) 

Returns the result of evaluating the given expression supplied as a 
string. For example, 

a=6 : b=7 

PRINT EVAL ("a + b") 

Exponent (function) 

Returns ‘e’ (2.71828183) to the power of the argument. 

Extent of file (function) 

Returns the total length of the file whose channel number is its 
argument. 

The file must have been opened with OPENIN, OPENUP, or OPENOUT. 

False (function) 

Returns the value zero representing logical false. For example, 

REPEAT PRINT "*" : UNTIL FALSE 



will continue forever. 
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FN Function (statement) 

Introduces a user-declared function. The first character of the function 
name can be a letter, underline, or a number. No spaces are allowed 
between the function name and the opening bracket of the parameter 
list (if any). 

FOR (F.) Start FOR loop (statement) 

Initialises a FOR ... NEXT loop. The loop is executed at least once for 
each of the values of the control variable in the specified range. 

FOR card=l TO 6 
PRINT card; 

NEXT card 

will print 



1 2 3 4 5 6 



GET/GET$ Wait for key (function) 

Waits for a key to be pressed on the keyboard. GET returns the ASCII 
value, and GET$ returns the corresponding single-character string. For 
example, 

REPEAT UNTIL GET = 13 
waits for [enter! to be pressed. 

GOSUB (GOS.) Call subroutine (statement) 

Calls a section of a program as a subroutine at a specified line number. 
Control returns to the next statement when RETURN is encountered in 
the subroutine. One subroutine may call another subroutine (or itself). 



10 GOSUB 400 
20 END 

400 PRINT"Hel lo" : RETURN 
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GOTO (G.) 



fflMEM (H.) 



IF 



INKEY/INKEY$ 



INPUT (I.) 



Go to line (statement) 

Transfers program control to a line with a specified or calculated line 
number. For example, 

GOTO 100 
GOTO (X*10) 

The use of the calculated GOTO, as in the second example, is not 
recommended as it will not be renumbered correctly by the RENUMBER 
command. 

High memory bound (function) 

A pseudo-variable which contains the address of the first byte of free 
memory. 

Condition (statement) 

Sets up a test condition which can be used to control the subsequent 
flow of the program. It is part of the IF ... THEN ...ELSE structure. The 
word THEN is optional under most circumstances. 

IF 1 ength=5 THEN 110 
IF A<C OR A>D GOTO 110 

IF A>C AND C> - D THEN GOTO 110 ELSE PRINT "CCL" 

Read key (function) 

Waits for up to a specified number of clock ticks (10ms each). If no key is 
pressed in the time limit, INKEY will return -1 and INKEY$ will return a 
null string; otherwise the INKEY function will return the ASCII value of 
the key pressed. 

Input value (statement) 

Inputs values from the keyboard. 

The INPUT statement normally prints a ? prompt for each variable in the 
list. Alternatively strings can be included in the list of variables to be 
printed as prompts ; omitting the comma after a string will suppress the 
question mark. For example: 

INPUT"Enter your age:" age%, "and your name",name$ 
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INPUT LINE Input a line (statement) 

Identical to INPUT except that the entire line, including commas, quotes 
and leading spaces is input into a string variable. 

INPUT LINE A$ 

INPUT# Input from file (statement) 

Reads data from a file into specified variables. 

The data should have been written to the file with a corresponding 
PRINT# statement. 



INSTR Substring (function) 

Returns the position of a substring within a string, optionally starting 
the search at a specified place in the string. The leftmost character 
position is 1. If the sub-string is not found, 0 is returned. 

For example, 

PRINT I N ST R ( "Z88" , "8" ) 
will print 2, and 

PRINT INSTRC'PipeDream" ,"e" ,5) 
will start the search at character 5 and print 7. 

INT Integer (function) 

Converts a real number to the next lower or equal integer. 

I NT (99. 8) is 99 
I NT (-12) is -12 
INT( -12.1) is -13. 

LEFTS Left of string (function) 

Returns a specified number of characters from the left of a string. If 
there are insufficient characters in the source string, all the characters 
are returned. 



Thus, if A$="BANANA" 



BASIC keywords 



209 



LEN 

LET 
LIST (L.) 



LISTO 



PRINT LEFTS ( A$ , 3 ) 
would print "BAN". 

Length of string (function) 

Returns the length of the argument string. For example, 

X=LEN"fred" 

will set X to 4. 

Assignment (statement) 

Optional before an assignment statement. 

List program (command) 

Lists the program. 



Examples 

LIST 


lists 


LIST 


.99 


lists 


LIST 


11. 


lists 


LIST 


11,99 


lists 


LIST 


55 


lists 



the entire program 
up to line 99 
from line 11 to the end 
lines 11 to 99 inclusive 
line 55 only 



To obtain a listing of a program to a printer connected to the Z88: 

© Attach and turn on the printer. 

© Type L I ST, type n+P, and press IenterI . 

® When finished, type n-P 

LIST options (command) 

Controls the appearance of a listed program. The number following the 
command specifies which of the following formatting options are 
required. 
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LN 

LOAD (LO.) 
LOCAL (LOC.) 

LOG 

LOMEM (LOM.) 

MTD$ 



Value 


Option 


0 


No inserted spaces 


1 


Space after line number 


2 


FOR ... NEXT loops indented 


4 


REPEAT ... UNTIL loops indented 



The numbers can be added to combine options, the default being 7. 

Natural logarithm (function) 

Returns the natural (Naperian) logarithm of its argument. 

Load program (command) 

Loads a new program from a file and clears the variables. For example 

LOAD "STAT4" or 

LOAD " : RAM .O/CONVERTER.BAS" 

Local variables (statement) 

Declares variables for local use inside a function (FN) or procedure 
(PROC). 

LOCAL A$ , X , Y% 

Logarithm (function) 

Returns the base- 10 logarithm of its argument. 

Lower memory bound (function) 

A pseudo-variable which controls where in memory the dynamic data 
structures are to be placed. The default is TOP, the first free address 
after the end of the program. 

Middle of string (function) 

Returns a string consisting of a specified number of characters of the 
string starting from a given position. For example 



A$ = M I D $ ( B $ , start, length) 
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MOD 



NEW 



NEXT(N.) 



NOT 



sets A$ to the substring of B$ starting at position ‘start’, and of length 
‘length’. If ‘length’ is omitted, or if there are insufficient characters in the 
string, then all the characters from ‘start’ onwards are returned. Thus 

PRINT MI D$( "DOZY" ,2,2) 

will print 

"0Z" 

Modulo (operator) 

Gives the signed remainder of the integer division. 

X=A MOD B 

is equivalent to 

X = A - ((A DIV B) *B) 

New program (command) 

Initialises the interpreter for a new program to be typed in. An old 
program may be recovered with the OLD command provided no program 
lines have been typed in. The variables @% and A% to 1% are preserved 
even after a NEW command. 

End FOR loop (statement) 

Ends a FOR ... NEXT loop. NEXT takes an optional control variable; if 
this is not the same as the variable supplied in the corresponding FOR 
statement, an error will occur. 

Logical NOT (operator) 

A unary operator (the same priority as unary -) giving a bit-by-bit binary 
inversion of the constant, variable, or mathematical or boolean 
expression to its right. Usually used in IF ... THEN or UNTIL statements 
to invert the sense of the condition. Expressions must be enclosed in 
brackets. 
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OLD 



ON 



ON ERROR 



OPENIN (OP.) 



Recover old program (command) 

Undoes the effect of NEW provided no lines have been typed in or 
deleted, no variables have been created, and no popdown or application 
has been entered. 

Multi-way switch (statement) 

Provides a multi-way GOTO or GOSUB, depending on the value of a 
control variable. The line numbers in the list may be constants or 
calculated, and the unwanted ones are skipped without calculation. For 
example: 

ON action GOSUB 1000,2000,3000,4000 

Error trap (statement) 

Provides error trapping. If an ON ERROR statement has been 
encountered, BASIC will transfer control to it (without taking any 
reporting action) when an error is detected. This allows error 
reporting/recovery to be controlled by the program. However, the 
program control stack is still cleared when the error is detected and it is 
not possible to return to the point where the error occurred. 

Note that under some circumstances ON ERROR can cause BASIC to 
generate repeated errors, requiring a soft-reset. This can be avoided by 
including a call to INKEY$, as in the following example, which will allow 
you to exit from BASIC to the Index and OKILL the activity: 

10 ON ERROR REPORT: Q$=I NKEY $ ( 100 ) 

20 ERROR 

Open file for input (function) 

Opens a file for reading or updating and returns the ‘channel number’ of 
the file, or 0 on failure. This number must be used in subsequent 
references to the file with BGET#, INPUT#, EXT#, PTR#, EOF# or 
CLOSE#. 
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OPENOUT Open file for output (function) 

Opens a file for writing and returns the ‘channel number’ of the file, or 0 
on failure. This number must be used in subsequent references to the 
file with BPUT#, PRINT#, EXT#, PTR# or CLOSE#. 

X=0 P E N 0 UT ( A$ ) 

X=0PEN0UT ( RAM. 0/ DATA. DAT" ) 

OPENUP (OPENU.) Open file for update (function) 

Opens a file for update and returns the channel number, or 0 on failure. 
Once a file is opened you can update it or extend it. 

OPT Assembler options (statement) 

An assembler pseudo operation controlling the method of assembly. 

It is followed by a number in the range 0 to 3 to specify the method of 
assembly: 



Option 


Action 


0 


errors suppressed, no listing 


1 


errors suppressed, listing 


2 


errors reported, no listing 


3 


errors reported, listing 



The code is assembled into memory at the address specified by P%. For 
example: 

10 DIM code 100 
20 FOR pass = 0 TO 3 STEP 3 
30 P%=code 
40 [ 

50 OPT pass 
60 

70 \ backslash introduces a comment 
80 \ standard Z80 mnemonics are used 
90 ] 

100 NEXT pass 
110 END 
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OR 

OSCLI 

PAGE (PA.) 

PI 

POS 

PRINT (P.) 



Alternatively the assembled code can be assembled into memory at the 
address specified by 0 % , with labels generated according to the value of 
P%, by adding 4 to each of these option values. 

Logical OR (operator) 

Gives the bitwise integer logical OR between two operands which are 
internally converted to 4 byte integers before the operation. 

Operating-system command (statement) 

Allows a string expression to be passed to the operating system. For 
example, in the BASIC editor (see Editing BASIC programs, p. 197) 

60220 OSCLI "*CLI .<" + B$ 

Program area (function) 

A pseudo-variable controlling the starting address of the current user 
program area. The lower byte of PAGE is always zero. 

Pi (function) 

Returns 3.141592653. 

Cursor position (function) 

Returns the horizontal position of the cursor on the screen. The left-hand 
column is 0 and the right-hand column is one less than the width of the 
display. 

Print text (statement) 

Prints characters on the screen or printer. 

Items may be separated by commas, semi-colons, or no separator: 

PRINT "ONE" 1% "TWO" 

Numbers are printed in a format determined by the value of the variable 
@%. This is set to a hexadecimal value as follows: 

@% = &SSNNPPWW 



where 
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SS determines the format of strings created by STR$. 

If SS= 01 then STR$ will use the format specified by @%, otherwise @% 
will be ignored. 

NN determines the notation format. 

NN= 00 General notation: integers will be printed with no decimal 
places, numbers between 0.1 and 1 will be printed as 0.1 etc, and 
numbers less than 0.1 will use scientific notation. 

NN= 01 Scientific notation: eg 100 is printed as 1E2. 

NN=02 Fixed format notation: if the number will fit into the specified 
field width, it will be displayed with the number of decimal places 
specified by PP. Otherwise general notation will be used. 

PP determines the number of decimal places to be printed. 

WW determines the overall print field width. 

By default, @ % = &0000090 A, giving general notation with a field width 
of 10 characters. Its value can be printed, in hexadecimal, with 

PRINT 

Numbers can be printed in hexadecimal by prefixing them with 

PRINT# (P.#) Write to file (statement) 

Writes the internal form of a list of variables, separated by commas, to a 
specified data file. 

PROC Procedure (statement) 

Introduces a user-declared procedure. The first character of a procedure 
name can be a letter, underline, or a number. No spaces are allowed 
between the procedure name and the opening bracket of the parameter 
list (if any). The procedure returns to the calling program with an 
ENDPROC statement. 

PTR# File pointer (function) 

A pseudo-variable allowing the random-access pointer of a specified file 
to be read and changed. For example, 
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PTR#F=PTR#F+5 

moves to the next floating-point number in the file with channel number 
F, since 5 bytes are allocated to each number. 

PUT Output to port (statement) 

Outputs data to a Z80 port. Should only be used by experienced 
programmers as incorrect use could damage the Z88. The full Z80 
extended addressing is available. 

PUT A,N : REM output N to port A. 

RAD Radians (function) 

Returns its argument converted from degrees to radians. For example: 
RAD ( 90 ) 



READ Read DATA statements (statement) 

Assigns to variables values read from the DATA statements in the 
program. Strings must be enclosed in double quotes if they have leading 
spaces or contain commas. 

READ A% , B , C $ 

DATA 27,-12. 34, "Hello" 



REM 



RENUMBER (REN.) 



REPEAT (REP.) 



Comment (statement) 

Introduces a comment, causing the rest of the line to be ignored. 

Renumber program (command) 

Renumbers the lines and corrects the cross references inside a program. 
The options are as for AUTO. 

REPEAT loop (statement) 

Introduces a REPEAT... UNTIL loop. For example: 



REPEAT PRINT 
UNTIL COUNT = 80 



will print 80 stars on the screen or printer. 
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REPORT (REPO.) 

RESTORE (RES.) 
RETURN (R.) 

RIGHTS 

RND 

RUN 



Report error (statement) 

Prints out the error string associated with the last error which occurred. 
If no error has occurred, prints the copyright string. 

Restore READ (statement) 

Sets the line from which subsequent READ statements will read data. 

Return from subroutine (statement) 

Causes a RETURN to the statement after the most recent GOSUB 
statement. 

Right of string (function) 

Returns a specified number of characters from the right-hand end of a 
string. If there are insufficient characters in the string then all are 
returned. For example: 

PRINT RIGHT$( "DOZY" ,3) 

will print OZY. 

Random number (function) 

Returns a random number. The type and range of the number returned 
depends upon the optional parameter, as follows: 



Value 




X<0 


Returns X and resets random number generator to -X. 


x=o 


Repeats last random number given by RND(l). 


X=1 


Returns a random number between 0 and 0.999999. 


X>1 


Returns a random integer between 1 and X inclusive. 



Run program (statement) 

Starts execution of the program after clearing all but the static variables 
@%, and A% to Z%. 
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SAVE (SA.) 



SGN 



SIN 

SPC 



SQR 



STEP (S.) 



Save program (statement) 

Saves the current program area to a file, in internal (tokenised) format. 

SAVE " myprog . BAS" 

SAVE A$ 

Sign (function) 

Returns -1, 0, or +1 depending on whether the argument is negative, 
zero or positive respectively. 

result=SGN(answer) 

Sine (function) 

Returns the sine of its argument taken in radians. 

Print spaces (statement) 

Prints a specified number of spaces. SPC can only be used as part of an 
INPUT or PRINT list; for example: 

PRINT "Name”; SPC ( 4 ) ; "Age”; SPC ( 6 ) ; "Address" 

Square root (function) 

Returns the positive square root of its argument. 
z=SQR (x A 2+y A 2) 

FOR loop increment (statement) 

Part of the FOR statement, this optional section specifies the step size. 
For example, 

FOR i=l TO 20 STEP 5 
PRINT i ; 

NEXT 



will print: 1 6 11 16 
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STOP 

STR$ 

STRINGS 

TAB 

TAN (T.) 
THEN (TH.) 



Stop program (statement) 

Syntactically identical to END, STOP also prints a message 

STOP at line X 

where X is the line number. 

String (function) 

Returns the string form of the numeric argument as it would have been 
printed. A number A% can be converted to a string in hexadecimal 
format with the function: 

STR$~A% 

Repeat strings (function) 

Returns a given number of repetitions of a string. 

A$=STRI NG$ ( 5 , " HA" ) 

will set A$ to ■HAHAHAHAHA". 

Move to screen position (statement) 

Moves the cursor to a given screen position. TAB can only be used as 
part of a PRINT or INPUT statement. 

There are two forms: 

TAB(X) will print spaces until the cursor reaches column X (on the same 
line, or next line). 

TAB(X,Y) will move the cursor directly to character position X,Y on the 
screen, where 0,0 corresponds to the top left-hand comer. 

Tangent (function) 

Returns the tangent of its argument taken in radians. 

Condition clause (statement) 



An optional part of the IF ... THEN ... ELSE statement. It introduces the 
action to be taken if the testable condition evaluates to TRUE. 




220 



Section Ten -BBC BASIC 



TIME (TI.) 



TIMES 



TO 



TOP 



TRACE (TR.) 



Time (function) 

A pseudo-variable which sets and reads the elapsed time clock. The 
value of TIME must be initialised before it is used; for example 

TIM E= 100 

resets the value of TIME to 100 centiseconds, and 
X=T IME 

sets X to the value of the current elapsed time. 

Time string (function) 

Returns a string giving the current date and time; for example: 
Wednesday 29 April 1987, 10:12:32 

The functions LEFTS, MID$, and RIGHTS can be used to extract parts of 
this string. For example, the time alone can be obtained by 

A$ = RIGHTS (TIMES , 8 ) 

PRINT A$ 

10:12:32 

Upper bound of FOR loop (statement) 

Introduces the terminating value for the loop in a FOR ... TO ... STEP 
statement. When the loop control variable exceeds the value following 
‘TO’, the loop is terminated. 

Top of program (function) 

Returns the value of the first free location after the end of the current 
program. 

Trace program (command) 

TRACE can be used to provide information on the execution of a 
program. TRACE ON causes the interpreter to print executed line 
numbers when it encounters them, for debugging. The facility can be 
turned off by typing TRACE OFF. 
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TRUE 
UNTIL (U.) 
USR 

VAL 

VDU (V. ) 

VPOS (VP.) 
WIDTH (W.) 



True (function) 

Returns the value -1, representing logical true. 

End REPEAT loop (statement) 

The end of a REPEAT ... UNTIL structure. 

Call machine-code (function) 

Enters a machine code routine at the address specified in its argument, 
passing the least-significant bytes of the integer variables A%, B% , C% , 
D%, E%, F%, H%, L%, and F% into the correspondingly -named registers 
of the Z80 on entry. 

Unlike CALL, USR returns a 32-bit result composed of the contents of the 
Z80’s H, L, H', and L’ registers, most-significant to least-significant. 

This function should only be used by experienced programmers. 

Value of string (function) 

Converts a character string representing a number into numeric form. 

X=VAL( a $ ) 

Output bytes to screen (statement) 

Takes a list of numeric arguments and sends their least-significant bytes 
as characters to the current 'output stream’. 

Vertical position (function) 

Returns the vertical cursor position. The top of the screen is line 0. 

Screen width (statement) 

Controls output overall field width. Initially WIDTH is 94 (the default). 

For example, before printing it is a good idea to set 

WIDTH 80 

to give a new line after every 80 characters of output. 
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*cu 



‘ERASE 



‘NAME 



‘RENAME 



Special Z88 information 



Send line to CLI (OZ command) 

Sends a command to the command line interpreter. For example, in the 
BASIC editor (see Editing BASIC programs, p. 197): 

60090 *CLI . * : RAM . 0/EE . CLI 

Erase a file (OZ command) 

Erases a specified file. For example, 

‘ERASE filename 
or using the CLI 
OSCLI "‘ERASE "+file$ 

Names the BASIC activity (OZ command) 

Gives the BASIC activity a name, which will be displayed in the list of 
SUSPENDED ACTIVITIES in the Index. 

‘NAME MYPROG 

Rename a file (OZ command) 

Renames a file; for example: 

‘RENAME oldfile newfile 

OSCLI "‘RENAME "+oldfile$+" "+newfile$ 



The following system information is available: 

PRINT ~PTR# -1 The number of channels left for use and the ROM 
release number 

PRINT EXT# -1 
PRINT EOF# -1 



Prints the estimated free memory in bytes 

Returns 0 for an unexpanded Z88, and -1 for an 
expanded Z88 with at least 128K in slot 1 



BASIC operators 



The following operators may be used as part of expressions. 

Arithmetic operators 

The arithmetic operators take two numbers as operands. 

+ add - subtract 

* multiply / divide 

a raise to the power 

Relational operators 

The relational operators can compare n umb ers, and return a logical 
value of FALSE =0 and TRUE=-1. 



< 


less than 


= equal to 


<= 


less than or equal to 


> greater than 


<> 


not equal to 


>= greater than or equal to 



Logical operators 

The logical operators operate on numeric or logical values. Boolean 
FALSE is taken as zero, TRUE as -1: 

Indirection operators 

The following operators allow the programmer to access memory 
directly (called PEEK in other versions of BASIC) or to alter the contents 
of specified memory locations (called POKE in other BASICs). 

These operators should only be used by experienced programmers, 
since they give the programmer the capability of altering the operation 
of other activities in the Z88 operating system; in general, only 
addresses within the region allocated by a BASIC DIM statement should 
be altered. 

? byte indirection ! word indirection 

$ string indirection 
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The usual way of using these operators is to allocate a vector using the 
DIM statement, and then manipulate elements of this vector with the 
indirection operators. For example, 

DIM vec 15 

allocates a vector of 16 bytes, and assigns its address to the variable 
vec. These bytes can be addressed as 



0 


1 


2 


V. 


! 4 


5 


6 


7 


8 


9 


10 


li 


12 




n 


n 


n 


1 


1 


n 


n 


n 


n 


n 


R 


R 


1 


1 


H 




vec?0 




vec?2 




vec?4 




vec?6 




vec?8 


i 


/echo 


veJ?12 



vec?l vec?3 vec?5 vec?7 vec?9 vec?ll 



Note that ? v e c is an alternative way of writing v e c ? 0 . 

A typical manipulation might be 
vec?l = vec?l + 1 

Alternatively the vector could be addressed as 4 four-byte words: 



01 23456789 10 11 12 




vec!0 



vec!4 



vec! 8 



vec! 12 



Finally, the string indirection operator allows a string to be stored 
directly into an area of memory. For example: 

Svec = “Z88 COMPUTER” 



stores characters in the vector as follows: 
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0 


1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


z 


8 


8 


&20 


C 


0 


M 


P 


U 


D 


E 


R 


&0D 



T 



$vec 

The string can be accessed with the $ operator, so the following 
statement will print the string: 

PRINT $vec 

Individual characters can be accessed with the ? operator. 



Order of precedence The order of precedence of the operators is as follows: 



Group 1 


- 


unary minus 




0 


brackets 




NOT 


logical NOT 


Group 2 


A 


raise to the power 


Group 3 


* 


multiply 




/ 


divide 


Group 4 


+ 


add 




- 


subtract 


Group 5 


< 


less than 




= 


equal to 




<= 


less than or equal to 




> 


greater than 




<> 


not equal to 




>= 


greater than or equal to 


Group 6 


AND 


Logical AND 


Group 7 


OR 


Logical OR 




EOR 


Logical Exclusive-OR 



so, for example, A-B*C A D is equivalent to A-(B*(C A D)). 
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Appendix A Replacing batteries 



If the battery low symbol appears as soon as the Z88 is switched on, the 
safest course of action is to replace the batteries as soon as possible. 

The computer should be switched off until new batteries have been 
obtained. 

The replacement batteries should be Alkaline cells, size AA, type 
MN1500 or LR6. 

Note that while you are exchanging batteries, the contents of the 
machine’s memory will be kept intact by the internal super capacitor. 
However, this will only maintain power for a limited time, so it is 
recommended that you power the Z88 from the mains power unit while 
changing batteries, especially if extra cards are fitted. 

In the absence of a mains unit, carry out the following actions promptly, 
and bear in mind the time limitations given below. 

Memory retention time 

The time available depends on the number of RAM cards fitted. With no 
RAM cards the machine will retain its data for 3 minutes. With one RAM 
card this will be reduced to about 1 minute. Use of two RAM cards will 
lead to a further reduction to about 30 seconds. 

It is not recommended that the machine be fitted with three RAM cards 
as this would require the use of slot 3 which is designed primarily for 
use with EPROM cards and, although it is possible to use it with RAM, a 
much higher power consumption would result. 

The time limi t does not depend on the size of RAM card used. EPROM 
cards do not affect the time limit in any slot. 

The times given are for the worst case situation. In general the limit will 
be twice as high, but this should not be relied upon. 

If you have a mains adaptor you can use it to power the Z88 while you 
change batteries. 
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Procedure 

Read the following procedure carefully, so that you can carry it out 

without pausing: 

© Remove the new batteries from their packaging, and place them 
within easy reach on the right-hand side of the Z88. 

© Switch the Z88 off by pressing both IshiftI keys simultaneously. 

© Place the Z88 keyboard-down, and remove the lid of the battery 
compartment. 

© Note the time, and calculate how long you have according to the 
table given on the previous page. 

© Remove the four batteries from the battery compartment, if 
necessary tilting the Z88 to slide the batteries out. 

© Throw the old batteries away, to avoid confusing them with the new 
replacements. 

® Place one of the new batteries at each end of the battery 

compartment, observing the polarity carefully. Place the remaining 
two batteries in an ‘A’ shape, and press down on the point of the ‘A’ 
so that they pop into place. 

© Check that the batteries are all orientated correctly. There is now no 
longer any time pressure. 

© Replace the battery-compartment lid firmly before turning the 
machine over again. 

DO NOT PRESS RESET. 

® Switch on, by pressing both IshiftI keys simultaneously. The Z88 
should now be working, and the battery-low indicator will not be 
displayed. 



Appendix B Serial port 



This appendix describes the pin connections for the Z88 serial 
connector. 

The following connections are for a cable to connect the Z88 serial port 
connector to a 25-pin D-type serial printer connector, or equivalent: 



Z88 

9 way D (Male) 




Printer - 
25 way D (Male) 


1 

2 TxD 


— > 


3 RxD 


3 RxD 


<- 


2 TxD 


4 RTS 


— > 


5 CTS 


5 CTS 


<— 




6 

7 GND 




7 GND 


8 DCD 


<- 




9 DTR 


— > 


6, 8 (DSR, DCD) 



where the signals are as follows: 



TxD 


Transmitted data 


RxD 


Received data 


RTS 


Request to send 


CTS 


Clear to send 


GND 


Signal ground 


DCD 


Data carrier detect 


DTR 


Data terminal ready 


Notes 





The Z88 RS232 port is wired as Data Terminal Equipment 

Pin 1 must not be used for RS232 signals. It carries +5v at 10(iA, even 
when the machine is OFF. 

Do not use pin 6 on the Z88 connector. 

Pin 9 is the RS232 DTR signal. It provides +5v at 1mA while the Z88 is 
switched on, for powering CMOS serial to parallel converters. 
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CTS on the Z88 must be high for the Z88 to transmit, and DCD must be 
high for the Z88 to receive. For simple RS232 use, connect pins 5 and 8 
to pin 9, and connect pins 2 (TxD), 3 (RxD), and 7 (GND) to the other 
computer. 

ASuspended message will be displayed if a battery low is flagged 
while sending or receiving, or if the Z88 is switched off or the flap is 
opened. In this case you must repeat the transfer. 




Appendix C Error messages 



PipeDream error messages 

-ve root 

AH columns zero width 
Bad argument 

Bad column 

Bad date 

Bad file 
Bad index 

Bad list file 

Bad name 

Bad number 

Bad option 
Bad range 



Bad slot 



The argument to the SQR function was negative; eg SQR(-l). 

Attempt to set the width of all columns to zero. 

The argument to a Next Match (OBNM) command was given with no 
prior Search command. 

The Sort (OBSO) command was given with an invalid column 
specification. 

The argument to the DAY, MONTH, or YEAR function is not a valid 
date; eg DAY(27). 

The file specified was not a valid file. 

A CHOOSE, or INDEX function was called with an invalid index; eg 
CHOOSE(-2,l). 

The list file loaded by the Load command (OFL) does not contain valid 
file names, or was not saved with the Save Plain text option. 

The name specified in a Load, Save, or Name command was not a valid 
file name. 

The argument to an Insert Highlights (OPHI), Remove Highlights 
(OPHR), Highlight Block (OPHB), or Decimal Places (OLDP) command 
was not in the valid range. 

The option was not valid for the command. 

The range of slots specified in a Replicate or Save command was not a 
valid range; eg, 

Say? only range of columns C R. 

The command was given an invalid slot reference; eg Go to Slot 
(OCGS) AO. 
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Bad A field 

Divide by 0 
Edge 

Editing expression 

End of list file 

Escape 
Exp range 
Expression too long 

FP overflow 

Log range 

Lookup 

Loop 

Memory full 
No list file 

No marked block 
Overlap 

Propagated 



The a sequence in a Search or Replace string was invalid; eg 

String to search for A H 

An expression attempted to divide by zero; eg 2/0. 

The block being copied or moved would not fit within the maximum 
possible sheet size; eg, an attempt to copy from A1 Z6 to AA1. 

The specified command is not available while editing an expression; eg, 
Load (OFL). 

The end of the List file has been reached; eg Bottom File (OFB) at the 
end of a document. 

The |sc] key was pressed while processing a document. 

The range of the EXP function was exceeded; eg EXP( 100). 

The string of text is too long to be entered into a slot; ie longer than 240 
characters. 

An expression resulted in a number too large to be represented; eg, 
100A100. 

The argument to the LOG function was invalid; eg LOG(-l). 

The LOOKUP function could not find a successful match. 

Two slots containing string values reference each other. 

No more memory is available for the current sheet. 

A multi-file command such as Bottom File (OFB) was given with no List 
file loaded, or after the List file was cancelled due to an error. 

The command requires a marked block; eg Move. 

The source and destination blocks, specified in a Move or Copy 
command, overlap. 

The expression slot refers to another slot with an error. 

The expression is too complex for evaluation. 



Stack overflow 




Error messages 
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Too few arguments 
Too long 

Too many columns 
Typing error 

Diary error messages 

Memory Low 

No String 
No Room 

No Marker 
Not Marked 

Date Range 
Overlaps 
n Found 



An IF, CHOOSE, or INDEX function has been specified with too few 
arguments; eg, INDEX(2). 

The length of line that would result after a Join Lines or Replace 
command is longer than 240 characters, or the string specified in a 
Search or Replace command is longer than 240 characters. 

The Add Column (<>EAC) or Insert Column (OEIC) command was given 
in a document which already has 42 columns, the maximum number. 

The expression is invalid; eg, Al+*3. 



Diary error messages are displayed in the DIARY DATE window 
between the date and mode. 

The user should take immediate action to delete data from the Diary, 
files, or suspended applications. Delete a line to free memory with o [del] , 
followed by OY to free more entries. 

Tried to Search or Replace with null string. 

The Save Position command (OCSP) was given with five positions 
already saved. 

Search/Replace between markers etc. 

Next/Previous Match (Search within block) when cursor is outside 
block. 

An attempt was made to move outside the legal date range. 

A block operation was attempted with the cursor inside the block. 

Final message after Replace command. 

In addition system error messages, such as ‘File not found' are displayed 
in another window on top of the operation being performed. 
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BASIC error messages 0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 
23 



No room 


24 


EXP range 


Out of range 


26 


No such variable 


Byte 


27 


Missing ) 


Index 


28 


Bad hex 


Mistake 


29 


No such FN/PROC 


Missing 




Bad call 


Type mismatch 


31 


Arguments 


No FN 


32 


No FOR 


$ range 


33 


Can't match FOR 


Missing " 


34 


FOR variable 


Bad DIM 


36 


No TO 


DIM space 


38 


No GOSUB 


Not LOCAL 


39 


ON syntax 


No PROC 




ON range 


Array 


41 


No such line 


Subscript 


42 


Out of DATA 


Syntax error 




No REPEAT 


Escape 




Syntax 


Division by zero 




Channel 


String too long 




End of file 






Suspended 


-ve root 




File not found 


LOG range 


252 


Read protected 


Accuracy lost 


252 


Write protected 










Appendix D Z88 character set 



Hex Dec Code Description Hex Dec Code Description 



00 


0 


NUL 


o= 


Nun 


20 


32 




01 


1 


S0H 


OA 


Start of Heading 


21 


33 


J 


02 


2 


STX 


OB 


Start of Text 


22 


34 


ii 


03 


3 


ETX 


oc 


End of Text 


23 


35 


# 


04 


4 


EOT 


OD 


End of Transmit 


24 


36 


$ 


05 


5 


ENQ 


OE 


Enquiry 


25 


37 


% 


06 


6 


ACK 


OF 


Acknowledge 


26 


38 


& 


07 


7 


BEL 


OG 


Bell 


27 


39 


i 


08 


8 


BS 


OH 


Backspace 


28 


40 


( 


09 


9 


HT 


OI 


Horizontal Tab 


29 


41 


) 


0A 


10 


LF 


OJ 


Line Feed 


2A 


42 


★ 


0B 


11 


VT 


OK 


Vertical Tab 


2B 


43 


+ 


OC 


12 


FF 


OL 


Form Feed 


2C 


44 




00 


13 


CR 


OM 


Carriage Return 


2D 


45 


- 


0E 


14 


SO 


ON 


Shift Out 


2E 


46 


w 


OF 


15 


SI 


O0 


Shift In 


2F 


47 


/ 


10 


16 


DLE 


OP 


Data Line Escape 


30 


48 


0 


11 


17 


DC1 


OQ 


X On 


31 


49 


1 


12 


18 


DC2 


OR 


Aux On 


32 


50 


2 


13 


19 


DC3 


os 


XOff 


33 


51 


3 


14 


20 


DC4 


OT 


Aux Off 


34 


52 


4 


15 


21 


NAK 


ou 


Negative Acknowledge 


35 


53 


5 


16 


22 


SYN 


ov 


Synchronous File 


36 


54 


6 


17 


23 


ETB 


ow 


End of Transmitted Block 


37 


55 


7 


18 


24 


CAN 


ox 


Cancel 


38 


56 


8 


19 


25 


EM 


OY 


End of Medium 


39 


57 


9 


1A 


26 


SUB 


oz 


Substitute 


3A 


58 




IB 


27 


ESC 


o[ 


Escape 


3B 


59 


‘ 


1C 


28 


FS 


o\ 


File Separator 


3C 


60 


< 


ID 


29 


GS 


O] 


Group Separator 


3D 


61 


= 


IE 


30 


RS 


OE 


Record Separator 


3E 


62 


> 


IF 


31 


US 


o- 


Unit Separator 


3F 


63 


? 
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Hex 


Dec 


Code 


Description 


Hex 


Dec 


Code 


Description 


40 


64 


@ 




60 


96 


O' 




41 


65 


A 




61 


97 


a 




42 


66 


B 




62 


98 


b 




43 


67 


C 




63 


99 


c 




44 


68 


D 




64 


100 


d 




45 


69 


E 




65 


101 


e 




46 


70 


F 




66 


102 


f 




47 


71 


G 




67 


103 


g 




48 


72 


H 




68 


104 


h 




49 


73 


I 




69 


105 


i 




4A 


74 


J 




6A 


106 


j 




4B 


75 


K 




6B 


107 


k 




4C 


76 


L 




6C 


108 


1 




4D 


77 


M 




6D 


109 


m 




4E 


78 


N 




6E 


110 


n 




4 F 


79 


0 




6F 


111 


0 




50 


80 


P 




70 


112 


P 




51 


81 


Q 




71 


113 


q 




52 


82 


R 




72 


114 


r 




53 


83 


S 




73 


115 


s 




54 


84 


T 




74 


116 


t 




55 


85 


U 




75 


117 


u 




56 


86 


V 




76 


118 


V 




57 


87 


W 




77 


119 


w 




58 


88 


X 




78 


120 


X 




59 


89 


Y 




79 


121 


y 




5A 


90 


Z 




7A 


122 


z 




5B 


91 


[ 




7 B 


123 


{ 




5C 


92 


\ 




7 C 


124 


1 

1 




5D 


93 


] 




7 D 


125 


} 




5 E 


94 


A 




7 E 


126 


~ 




5F 


95 






7 F 


127 


DEL 


Delete 










AO 


160 


... 


Exact space 










A7 


163 


£ 


Pound 
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Special characters 


Character modes 




These are obtained by executing VDU 1, n from 


VDU 


l.ASCB" 


Bold toggle 


BASIC, where n is the number of the character. 


VDU 


1, ASCF" 


Flash toggle 


VDU 


l.ASC"G" 


Grey toggle 


Code Character 


VDU 


1 ,ASC"R" 


Reverse toggle 


32 Dot space 


VDU 


l.ASCT" 


Tiny font toggle 


33 Alarm bell 


VDU 


l.ASC-U" 


Underline toggle 



39 Aposed 1 

42 Square 

43 Diamond 

45 Shift 

224 'SPACE' sign (3 char) 

225 'ENTER' sign (3 char) 

226 'TAB' sign (3 char) 

227 'DEL' sign (3 char) 

228 -ESC' sign (3 char) 

229 'MENU sign (3 char) 

230 'INDEX' sign (3 char) 

231 'HELP sign (3 char) 

240 Hollow left arrow 

241 Hollow right arrow 

242 Hollow down arrow 

243 Hollow up arrow 

244 Head arrow left 

245 Head arrow right 

246 Head arrow down 

247 Head arrow up 

248 Arrow left 

249 Arrow right 

250 Arrow down 

251 Arrow up 



Appendix E PipeDream file format 



The PipeDream file format is designed to facilitate manipulation by other 
programs. Apart from carriage return characters which are used as 
separators, no control characters or characters above 127 in value 
appear in the file (unless they have been explicitly typed in). The files 
are sequential, and can be edited by any text editor. 

PipeDream constructs 

Information about the structure of the file is stored in constructs 
consisting of one or more alphabetic characters between percent signs. 
Additional information relevant to the construct may be included before 
the final percent sign. 

The file begins with a group of Options Page constructs giving the 
values of the Options Page parameters for the file. This is followed by 
the main body of the file. 

Each column in the file is preceded by a Column construct giving 
details about the column, and followed by an entry for each slot in the 
column. 

Each slot entry may include a collection of constructs giving details 
about the slot, and is terminated by a carriage return character. 

Options Page construct 

%OP%parameter value cr 

parameter two characters identifying the parameter 

value the value of the parameter 

c r carriage return character 

The various parameter values are: 

AM Auto/manual 

EM Bottom margin 

BO Borders 

DE Title 

DP Decimal places 
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FM 


Footer margin 


FO 


Footer 


HE 


Header 


HM 


Header margin 


IW 


Insert on wrap 


JU 


Justify 


LM 


Left margin 


LP 


Leading characters 


LS 


Line spacing 


MB 


Minus/brackets 


PA 


Pages 


PL 


Page length 


PS 


Page no. start 


RC 


Rows/columns 


TM 


Top margin 


TN 


Text/numbers 


TP 


Trailing characters 


WR 


Wrap 


Column construct 


%C0 : col umn ,wi dth,wrap-width% 


col umn 


letter identifying the column 


wi dth 


decimal number giving the column width 


wrap-width 


decimal number giving the wrap-width 


These constructs can appear anywhere in the entry for each 


%B% 


brackets format 


%C% 


centre align 


%Dn% 


decimal places, n gives the number 


%DF% 


floating format 


%F% 


free align 


%Hn% 


highlight character: n gives the number 


%JL% 


justify left 


%JR% 


justify right 


%L% 


left align 


%LC% 


leading character format 


%LCR% 


LCR align 


%Pn% 


page break: n gives the argument, 0 for 
unconditional 
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%PC% 

%R% 

%TC% 

%V% 



percent character 
right align 

trailing character format 
slot is a number slot 



General format: 



construct text 



construct text 



cr 



construct 

text 

cr 



one of the constructs above 

ASCII characters being the slot contents 

carriage return character 



Appendix F Z88 specification 



Power source 4 x AA Alkaline Cells (MN1500, LR6) providing 20 hours of use 

AC Mains adaptor (6.5 v DC ±10%), 500 mA, centre positive. 

Weight 900 g (1.98 lb). 

Dimensions 294 mm (L) x 2 10 mm (D) x 23 mm (H) ( 1 1 V2 * x 8 V4 * x 7 /e ') 

Keyboard QWERTY, silent, 64 keys including INDEX, MENU, and HELP. 

Sound Miniature loudspeaker, used for alarm or warning. 

Serial I/O Port RS232, connector 9-way 'D' female. 

Operating system Unique to Z88 (concurrent, 4M Bytes address range). 

Operating temperature 0°C to 40“C (32“F to 104”F). 

Microprocessor CMOS Z80 

Internal memory RAM CMOS 32K Bytes 

ROM CMOS 128K Bytes 

Memory cards Slots 1, 2, or 3 1M Byte per card maximum 

Slot 3 also programs EPROM cards. 

CMOS RAM Random Access Memory. Data retained while machine is powered. 

CMOS EPROM Erasable, Programmable, Read-Only Memory 

Data retention measured in years. Card can be removed from Z88 
without data loss. Eraser available from Cambridge Computer Limited. 
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A 

ABS (BASIC keyword) 199 
ABS (PipeDream function) 153 
ACS (BASIC keyword) 199 
ACS (PipeDream function) 153 
active days in the Diary 76 
Add Column (PipeDream command) 
123 

Alarm 13, 78 

Align commands in PipeDream 42 
alignment commands in PipeDream 
134 

Alternative font (PipeDream 
command) 148 
AND (BASIC keyword) 199 
application cards 98 
applications 11 
entering 19, 93 
ASC (BASIC keyword) 199 
ASN (BASIC keyword) 200 
ASN (PipeDream function) 154 
assembler 213 
ATN (BASIC keyword) 200 
ATN (PipeDream function) 154 
AUTO (BASIC keyword) 200 

B 

BASIC 195 

error messages 236 
programs, editing 182, 197 
running 196 
basic concepts 15 
batteries 6 
inserting 7 
replacing 229 
BBC BASIC 12, 195 



Beginning of Line (PipeDream 
command) 115 
BGET# (BASIC keyword) 200 
BLOCKS menu in PipeDream 104 
Bold (PipeDream command) 148 
Bottom File (PipeDream command) 
129 

Bottom of Column (PipeDream 
command) 57, 116 
BPUT# (BASIC keyword) 200 

c 

Calculator 13 
functions 70 
Calendar 13 

used with Diary 68 
CALL (BASIC keyword) 201 
CAPS LOCK key 17 
Caps mode 17 
OCARD 94 
CARD command 94 
CARD error 95, 98 
cards 

errors 95 
installing 94 

Catalogue EPROM (Filer command) 
84 

Catalogue Files (Filer command) 84 
Centre Align (PipeDream command) 
42, 134 

CHAIN (BASIC keyword) 201 
characters, special 239 
CHOOSE (PipeDream function) 154 
CHR$ (BASIC keyword) 202 
CLEAR (BASIC keyword) 202 
Clear Mark (Diary command) 162 
■*CLI 222 
CLI 179 



CLI file-control commands 180 
CLI files, examples 182 
CLI key sequences 180 
Clock 13, 77 

CLOSE# (BASIC keyword) 202 
CLS (BASIC keyword) 202 
COL (PipeDream function) 154 
column widths in PipeDream 131 
columns in PipeDream 40 
command-line interpreter 179 
computer typeface 4 
constants, in the Calculator 72 
control keys, in Terminal 185 
conventions 4 
Copy (Diary command) 162 
Copy (Filer command) 85 
Copy (PipeDream command) 108 
copying blocks in PipeDream 108 
COS (BASIC keyword) 202 
COS (PipeDream function) 154 
COUNT (BASIC keyword) 202 
COUNT (PipeDream function) 154 
Create Directory (Filer command) 178 
Cursor Down (Diary command) 167 
Cursor Down (PipeDream command) 
116 

Cursor Left (Diary command) 167 
Cursor Left (PipeDream command) 
115 

Cursor Right (Diary command) 167 
Cursor Right (PipeDream command) 
115 

Cursor Up (Diary command) 167 
Cursor Up (PipeDream command) 116 
cursor keys 16 

in PipeDream 38 
cursor operations 
in PipeDream 117 
in the Diary 169 
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Index 



D 

DATA (BASIC keyword) 203 
data transfer 231 
database example 46 
date format 88 
dates in PipeDream 152 
DAY (PipeDream function) 155 
Decimal Places (PipeDream 
command) 63 

Decimal Places (PipeDream 
command) 136 
DEF (BASIC keyword) 203 
Default Format (PipeDream 
command) 137 
DEG (BASIC keyword) 203 
DEG (PipeDream function) 155 
DEL key 16 

in PipeDream 38 
DELETE (BASIC keyword) 203 
Delete (Diary command) 163 
Delete (PipeDream command) 108 
Delete Character (PipeDream 
command) 40, 119 

Delete Column (PipeDream command) 
121 

Delete Line (Diary command) 171 
Delete Row (PipeDream command) 

121 

Delete Row in Column (PipeDream 
command) 120 
Delete to End of Line (Diary 
command) 170 

Delete to End of Slot (PipeDream 
command) 120 

Delete Word (Diary command) 170 
Delete Word (PipeDream command) 
119 

device specification 176 
devices 81 
Diary 12, 65 

error messages 235 
screen 65 

use with Calendar 68 
DIM (BASIC keyword) 203 



DIV (BASIC keyword) 204 

Down Directory (Filer command) 178 

E 

EDIT menu in PipeDream 118 
Edit Expression (PipeDream 
command) 58 

Edit Expression (PipeDream 
command) 123, 150 
editing expression slots in PipeDream 
123 

editing within a slot in PipeDream 
119 

ELSE (BASIC keyword) 204 
END (BASIC keyword) 204 
End of Line (Diary command) 167 
End of Line (PipeDream command) 

115 

ENDPROC (BASIC keyword) 204 
ENTER (Diary command) 166 
ENTER (PipeDream command) 116 
ENTER key 16 

in PipeDream 39 
EOF# (BASIC keyword) 204 
EOR (BASIC keyword) 205 
EPROM cards 96 
EPROM eraser 97 
EPROMs, use with Filer 85 
‘ERASE 222 

Erase (Filer command) 86 
ERL (BASIC keyword) 205 
ERR (BASIC keyword) 205 
error messages 
BASIC 236 
Diary 235 
PipeDream 233 
ESC key 16 

Escape (PipeDream command) 124 
EVAL (BASIC keyword) 205 
exact space 17, 121 
Execute (Filer command) 178, 179 
executing a file on reset 183 
executing a program from the Alarm 
79 



Exit (Terminal command) 185 
EXP (BASIC keyword) 205 
EXP (PipeDream function) 155 
expression slots 36, 58, 150 
EXT# (BASIC keyword) 205 
Extended Sequence (PipeDream 
command) 148 
extensions, in file names 81 

F 

FAIL error 95 

FALSE (BASIC keyword) 205 
FCC compliance iii 
Fetch from EPROM (Filer command) 
85 

File name, in PipeDream 125 
file names 81 

full specification 175 
Filer 13, 80 

Filer commands 83, 177 
Filer reference 175 
FILES menu in PipeDream 125 
FILES menu in PrinterEd 193 
finding information in PipeDream 52 
First Active Day (Diary command) 169 
First Column (PipeDream command) 
57, 116 

First Line (Diary command) 167 
Fix Column (PipeDream command) 
135 

Fix Row (PipeDream command) 135 
FN (BASIC keyword) 206 
foot 7 

footers in PipeDream 142 
FOR (BASIC keyword) 206 
Format Paragraph (PipeDream 
command) 120 
format, PipeDream 240 
formatting in PipeDream 35, 121 
Free Align (PipeDream command) 135 
functions in PipeDream 153 
FX800 printer 187 



Index 
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G 

GET/GET$ (BASIC keyword) 206 
Go to Slot (PipeDream command) 114 
GOSUB (BASIC keyword) 206 
GOTO (BASIC keyword) 207 

H 

hard reset 24 

headers in PipeDream 142 
headings, fixing 135 
HELP key 16 
help 25 

hierarchical filing system 80 
Highlight Block (PipeDream 
command) 149 
highlight codes 42, 148 
in PrinterEd 188 
highlight commands 41 
highlighting text 148 
HIMEM (BASIC keyword) 207 
home expenses example 56 

I 

IF (BASIC keyword) 207 
IF (PipeDream function) 155 
Import/Export 14, 90 
protocol 91 

INDEX (PipeDream function) 155 
INDEX error 95 
INDEX key 16 
Index 13, 18 
screen 18, 92 

INKEY/INKEY $ (BASIC keyword) 207 
INPUT (BASIC keyword) 207 
INPUT# (BASIC keyword) 208 
INPUT LINE (BASIC keyword) 208 
Insert Character (Diary command) 171 
Insert Character (PipeDream 
command) 119 

Insert Column (PipeDream command) 
122 



Insert Highlights (PipeDream 
command) 149 

Insert Line (Diary command) 171 
Insert Page (PipeDream command) 
121 

Insert Reference (PipeDream 
command) 123 

Insert Row (PipeDream command) 41, 
122 

Insert Row in Column (PipeDream 
command) 120 

insert mode in PipeDream 119 
Insert/Overtype (Diary command) 170 
Insert/Overtype (PipeDream 
command) 119 

inserting a line in PipeDream 41 
INSTR (BASIC keyword) 208 
INT (BASIC keyword) 208 
INT (PipeDream function) 156 
Inverted Caps mode 17 
in BASIC 197 

Italic (PipeDream command) 148 

J 

jam sequence, in CLI 181 

Join Lines (Diary command) 171 

Join Lines (PipeDream command) 120 

K 

keyboard 15 
keyboard options 87 
keyboard, cleaning 17 
keycap legends 5 
OKILL 20, 94 
KILL 98 

L 

Last Active Day (Diary command) 168 
Last Column (PipeDream command) 
57, 116 

Last Line (Diary command) 167 
LAYOUT menu in PipeDream 131 



layout, altering in PipeDream 42 
LCR Align (PipeDream command) 134 
Leading Characters (PipeDream 
command) 63, 136 

Left Align (PipeDream command) 134 

LEFT$ (BASIC keyword) 208 

LEN (BASIC keyword) 209 

LET (BASIC keyword) 209 

line editing 24 

LIST (BASIC keyword) 209 

List (Diary command) 163 

list file 126, 128 

LISTO (BASIC keyword) 209 

lists in expression slots 152 

LN (BASIC keyword) 210 

LN (PipeDream function) 156 

LOAD (BASIC keyword) 210 

Load (Diary command) 172 

Load (PipeDream command) 44, 126 

loading a BASIC program 210 

loading in PipeDream 44 

LOCAL (BASIC keyword) 210 

LOCK OUT state 79 

LOG (BASIC keyword) 210 

LOG (PipeDream function) 156 

LOMEM (BASIC keyword) 210 

LOOKUP (PipeDream function) 156 

M 

Margin Left (PipeDream command) 
132 

Margin Right (PipeDream command) 
132 

margins in PipeDream 131, 142 
Mark Block (Diary command) 162 
Mark Block (PipeDream command) 50 
marking blocks in PipeDream 50, 104 
MAX (PipeDream function) 1 57 
Memory Free (Diary command) 171 
memory low 24 
MENU key 16 
menu, selecting 21 
Microspace pitch (PipeDream 
command) 147 
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microspacing in PrinterEd 191 
MID$ (BASIC keyword) 210 
MIN (PipeDream function) 157 
MOD (BASIC keyword) 211 
MONTH (PipeDream function) 157 
Move (Diary command) 162 
Move (PipeDream command) 108 
moving around a PipeDream 
document 57 

moving between days in the Diary 66 
moving blocks in PipeDream 108 
moving in PipeDream 1 14 
moving within the Calendar 75 
multi-column document, creating 132 
multi-file documents in PipeDream 
126, 128, 147 
multi-file example 129 

N 

•NAME 222 

Name (PipeDream command) 126 
Name (PrinterEd command) 193 
Name Match (Filer command) 179 
name and address list example 46 
NEW (BASIC keyword) 211 
New (PipeDream command) 44, 113 
New (PrinterEd command) 193 
NEXT (BASIC keyword) 211 
Next Active Day (Diary command) 168 
Next Column (PipeDream command) 
116 

Next Day (Diary command) 168 
Next File (PipeDream command) 129 
Next Match (Diary command) 164 
Next Match (PipeDream command) 

53, 109 

Next Option (Diary command) 171 
Next Option (PipeDream command) 
139 

Next Word (Diary command) 167 
Next Word (PipeDream command) 115 
NM in Filer DIRECTORY window. 179 
NOT (BASIC keyword) 211 



Number < > Text (PipeDream 
command) 124 

number formats in PipeDream 63, 136 

o 

OLD (BASIC keyword) 212 
ON (BASIC keyword) 212 
ON ERROR (BASIC keyword) 212 
OPENIN (BASIC keyword) 212 
OPENOUT (BASIC keyword) 213 
OPENUP (BASIC keyword) 213 
operations 

executing 22 
selecting 22 
operators 

in BASIC 223 
in PipeDream 152 
precedence of 225 
OPT (BASIC keyword) 213 
OPTIONS menu in PipeDream 138 
Options Page (PipeDream command) 
46 

Options Page 138 
Options Page in PipeDream 46 
Options Page options 
Auto/Man 141 
Borders 140 
Columns/Rows 141 
Decimal places 141 
File 138 
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